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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI Technical Committee Smart Card Platform (SCP). 

The contents of the present document are subject to continuing work within TC SCP and may change following formal 
TC SCP approval. If TC SCP decides to modify the contents of the present document, it will be re-released by EP SPC 
with an identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document covers the minimum characteristics considered necessary in order to provide compliance to 
TS 102 588 [2]. 

It describes the technical characteristics and methods for testing the SCWS API for Java Card™ (TS 102 588 [2]) 
implemented in a UICC platform. It specifies the following parts: 

test applicability; 

test environment description; 

tests format; 

test area reference; 

conformance requirements; 

test suite files; 

test procedure; 

test coverage; and 

a description of the associated testing tools that shall be used. 



2 References 

References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the 
reference document (including any amendments) applies. 

• In the case of a reference to a TC SCP document, a non specific reference implicitly refers to the latest version 
of that document in the same Release as the present document. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are necessary for the application of the present document. 

[1] ISO/lEC 9646-7 (1995): "Information technology - Open Systems Interconnection - Conformance 

testing methodology and framework - Part 7: Implementation Conformance Statements". 

[2] ETSI TS 102 588: "Smart Cards; Application invocation Application Programming Interface 

(API) by a UICC webserver for Java Card'^ platform". 

[3] ETSI TS 102 483: "Smart cards; UICC-Terminal interface; Internet Protocol connectivity between 

UICC and terminal". 

[4] OMA: "Smartcard -Web Server Enable Architecture", OMA-AD-Smartcard-Web-Server-Vl-0- 

20080421 -A. 

NOTE: Available at http://www.openmobilealUance.org/technical/release program/SCWS vl O.aspx . 
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[5] OMA: "Smartcard-Web-Server", OMA-TS-Smartcard-Web-Server-Vl-O-20080421-A. 

NOTE: Available at http://www.openmobilealliance.org/technical/release program/SCWS vl O.aspx . 

[6] Sun Microsystems Java Card'''^ Specification: "Java Card'"^ 2.2.2 Application Programming 

Interface". 

[7] Sun Microsystems Java Card^^ Specification: "Java Card^^ 2.2.2 Runtime Environment 

Specification". 

[8] Sun Microsystems Java Card''^ Specification: "Java Card^"^ 2.2.2 Virtual Machine Specification". 

NOTE: SUN Java Card Specifications can be downloaded at http://iava.sun.com/products/iavacard . 

[9] ETSI TS 102 268: "Smart Cards; Test specification for the UICC Application Programming 

Interface (AP)I for Java Card''^". 

[10] ETSI TS 101 220: "Smart Cards; ETSI numbering system for telecommunication application 

providers". 

[11] ETSI TS 102 223: "Smart Cards; Card Application Toolkit (CAT)". 

[12] ETSI TS 102 241: "Smart Cards; UICC Application Programming Interface (UICC API) for Java 

Card(TM)". 

[13] ETSI TS 102 221: "Smart Cards; UICC-Terminal interface; Physical and logical characteristics". 

2.2 Informative references 

The following referenced documents are not necessary for the application of the present document but they assist the 
user with regard to a particular subject area. 

[i.l] ETSI TS 102 600: "Smart Cards; UICC-Terminal interface; Characteristics of the USB interface". 

[i.2] HttpClient project. 

NOTE: Available at http://hc.apache.org/httpcomponents-client/index.html . 



Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

applet installation parameters: values for applet installation parameters 

Conformance Requirement Reference (CRR): description of the expected SCWS behaviour according to 
TS 102 588 [2] 

expected state: state in which the UICC is supposed to be after the execution of the test procedure applied on the 
relevant initial conditions 

security parameters: minimum security requirements defined for the applet installation process 

test area: set of Test Cases applicable to a specific part (class method, SCWS RE behaviour, etc.) of TS 102 588 [2] 

test case: elementary test that checks for compliance with one or more Conformance Requirement References 

test procedure: sequence of actions/commands to perform all the test cases defined in a test area 

test source file: Java file containing methods that will load and install test applet in the card, execute and verify the test 
results, and restore the Default Initial Conditions on the UICC (when possible) 
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test toolkit applet: applet designed to test a specific functionality of the SCWS API (TS 102 588 [2]) 



3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 



AID 

API 

BIP 

CAT 

CRR 

CRRC 

CRRN 

CRRP 

IP 

JCRE 

HTTP 

RE 

sews 

USB 



Application IDentifier 

Application Programming Interface 

Bearer Independent Protocol according to TS 102 223 [1 1] 

Card Application Toolkit 

Conformance Requirements Reference 

Conformance Requirement Reference Context Error 

Conformance Requirement Reference Normal 

Conformance Requirement Reference Parameter Error 

Internet Protocol 

Java Card'^ Run-time Environment 

HyperText Transfer Protocol 

Runtime Environment 

Smart Card based Web Server according to OMA specifications [4] and [5] 

Universal Serial Bus interface according to TS 102 600 [i.l] 



4 Applicability 

4.1 Applicability of the present document 

This present test specification apphes to UICCs containing a SCWS invocation API according to TS 102 588 [2]. 

4.2 Applicability of the individual test cases 

Table A.l lists the optional features for which the supplier of the implementation states the support. 

4.3 Applicability to different Releases 

The applicability to different releases specified in table B.l of the present document shall apply, unless otherwise 
specified. 



4.4 



Definitions 



4.4.1 Format of table of the table of optional features 

The columns in table A. 1 have the following meaning. 



Column 


Meaning 


Option: 


The optional feature supported or not by tlie implementation. 


Status: 


See clause 4.4.3 'Status and Notations' 


Support: 


The support columns shall be filled in by the supplier of the implementation. The following common 
notations, defined in ISO/IEC 9646-7 [1], are used for the support column in table A.1. 
Y or y supported by the implementation 
N or n not supported by the implementation 

N/A, n/a or - no answer required (allowed only if the status is N/A, directly or after evaluation of a 
conditional status) 


Mnemonic: 


The mnemonic column contains mnemonic identifiers for each item. 
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4.4.2 Format of the applicability table 

The applicability of every test in table B. 1 is formally expressed by the use of Boolean expression defined in the 
following clause. 

The columns in table B.l have the following meaning. 



Column 


Meaning 


Test case: 


The "Test case" column gives a reference to the test case number(s) detailed in the present document 
and required to validate the implementation of the corresponding item in the "Description" column 






Release: 


The "Release" column gives the Release applicable and onwards, for the item in the "Test case" column 






Support: 


The "Support" column is blank in the proforma, and shall be completed by the manufacturer in respect of 
each particular requirement to indicate the choices, which have been made in the implementation. 



4.4.3 Status and Notations 

The following notations, defined in ISO/lEC 9646-7 [1], are used for the status column: 



M 

O 

N/A 

X 

O.i 

Ci 



mandatory - the capability is required to be supported. 

optional - the capability may be supported or not. 

not applicable - in the given context, it is impossible to use the capability. 

prohibited (excluded) - there is a requirement not to use this capability in the given context. 

qualified optional - for mutually exclusive or selectable options from a set. "i" is an integer which 
identifies an unique group of related optional items and the logic of their selection which is 
defined immediately following the table. 

conditional - the requirement on the capability ("M", "O", "X" or "N/A") depends on the support 
of other optional or conditional items, "i" is an integer identifying an unique conditional status 
expression which is defined immediately following the table. For nested conditional expressions, 
the syntax "IF ... THEN (IF ... THEN ... ELSE...) ELSE ..." shall be used to avoid ambiguities. 



4.5 Table of optional features 



Table A.I : Options 



Item 


Option 


Status 


Support 


Mnemonic 


1 


ScwsExtension.doGetQ 


M 




doGet 


2 


ScwsExtension.doPostO 


M 




doPost 


3 


ScwsExtension.doHeadO 


M 




doHead 


4 


ScwsExtension.doPutO 


M 




doPut 


5 


ScwsExtension.doDeleteQ 


M 




doDelete 


6 


ScwsExtension.doOptionsO 







doOptions 


7 


ScwsExtension.doTraceO 







doTrace 
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4.6 Applicability table 



Table B.1 : Applicability of tests 



Test 
case 


Description 


Release 


Rel-7 


Support 




Class ScwsExtensionRegistry 








6.1.1.1 


Method register 


Rel-7 


M 




6.1.1.2 


Method deregister 


Rel-7 


M 






Class ScwsExtensionService 








6.1.3.1 


Method doDelete 


Rel-7 


M 




6.1.3.2 


Method doGet 


Rel-7 


M 




6.1.3.3 


Method doHead 


Rel-7 


M 




6.1.3.4 


Method doOptions 


Rel-7 


C001 




6.1.3.5 


Method doPost 


Rel-7 


M 




6.1.3.6 


Method doPut 


Rel-7 


M 




6.1.3.7 


Method doTrace 


Rel-7 


C002 






Interface HttpRequest 








6.1.4.1 


Method findAndCopyKeywordValue 


Rel-7 


M 




6.1.4.2 


Method findAndCopyKeywordValue 


Rel-7 


M 




6.1.4.3 


Method getContentLength 


Rel-7 


M 




6.1.4.4 


Method getContentType 


Rel-7 


M 




6.1.4.5 


Method getRequestHttpVersion 


Rel-7 


M 




6.1.4.6 


Method readContent 


Rel-7 


M 




6.1.4.7 


Method readContentType 


Rel-7 


M 






Interface HttpResponse 








6.1.5.1 


Method appendContent 


Rel-7 


M 




6.1.5.2 


Method appendHeaderVariable(byte[] data, short offset, short length) 


Rel-7 


M 




6.1.5.3 


Method appendHeaderVariable (byte[] name, short nameOffset, short 
nameLength, byte[] value, short valueOffset, short valueLength) 


Rel-7 


M 




6.1.5.4 


Method appendHeaderVariable (short headerKeywordNameld, byte[] value, 
short valueOffset, short valueLength) 


Rel-7 


M 




6.1.5.5 


Method enableChunkMode 


Rel-7 


M 




6.1.5.6 


Method finalizeHeader 


Rel-7 


M 




6.1.5.7 


Method flush 


Rel-7 


M 




6.1.5.8 


Method getRemainingResponseBufferSize 


Rel-7 


M 




6.1.5.9 


Method reset 


Rel-7 


M 




6.1.5.10 


Method sendError 


Rel-7 


M 




6.1.5.11 


Method setContentType 


Rel-7 


M 




6.1.5.12 


Method writeStatusCode 


Rel-7 


M 






sews Runtime Environment: Applet state 








6.2.1.1 


Invokation of applets not in state selectable 


Rel-7 


M 




6.2.1.2 


Registration remains valid if applet is not in selectable state 


Rel-7 


M 






SOWS Runtime Environment: Exception handling 








6.2.3.1 


No exception shall be propagated as HTTP error to the terminal 


Rel-7 


M 




C001 : IF (doOptions) THEN M ELSE N/A. 
C002: IF (doTrace) THEN M ELSE N/A. 





5 Test environment 

This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 

The test cases described in the present document shall be performed independently of the interface used between the 
UICC and the terminal. In particular, any test case shall have the same result regardless of using BIP in Server Mode as 
defined in TS 102 223 [11] or an IP connection according to TS 102 483 [3] and TS 102 600 [i.l]. 
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5.1 Test environment description 

The general architecture for the test environment is: 



Scope of the Test Suite. 
■ Elements of the Test Suite 



TS 102 241 [12] 
and Java Card^M 



Conversion 
parameter 



Test sews 
applet 



Applet ".cap" 



H 



Applet 

installation 

parameter 



Test Procedure 
exchange 



APDU cmd 



APDU cmd, 
response 



y 



HTTP 
Request 



TERMINAL 



Converter 



Loader 



APDU I/O 



APDU (BIP) 



Bip gateway 



Socket (TCP) 



HTTP 
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Figure 5.1 

5.2 Tests format 
5.2.1 Test area reference 

Each test area is referenced as follows: 

For API Testing: API_[package name]_[class name]_[method name]' where 

• package name: 

uicc. sews: '1'. 

• class name: 

yyy: 3 letters for each class. 

See annex A for full classes acronyms list. 
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• method name: 

zzzz[input parameters]: 

See annex A for full methods name acronyms list. 
For sews Framework testing: 'API_2_[clause name]_[subclause name]' where 

• Clause name: 

xxx: 3 letters for each clause. 

See annex A for full clause acronyms list. 

• Subclause name: 

yyyy: 4 letters for each subclause. 

See annex A for full subclause acronyms list. 

5.2.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

• Method prototype as listed in TS 102 588 [2]. 

• Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN). 

• Parameters error: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP). 

• Context error: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC). 

5.2.1.2 Test area files 

The files included in the Test Area use the following naming convention: 

• Test Source: Test_[Test Area Reference]. Java 

• Test Applet: [Test Area Reference]_[Test applet number] .Java 

• Cap File: [Test Area Reference]. cap 
The applet numbers start from '1'. 

The test source shall use the common interfaces defined in annex C. 

The Cap File format is described in Java Card'^ Virtual Machine Specification [8]. 

Test files can be run in any order. 

All files from the same test area are located in the same subfolder. 



£75/ 



(Release 7) 



15 



ETSI TS 102 835 V7.1.0 (2010-10) 



5.2.1 .3 Test procedure 

Each test procedure contains a table to indicate the expected responses form the API and/or the HTTP level as follows. 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 




Test Case detailed description 


API and/or SOWS Frameworl< expected beliaviour. Expected response at HTTP level. 



5.2.1.4 



Test coverage 



The table above each test procedure indicates the correspondence between the Conformance Requirements Reference 
(CRR) and the different test cases. 



5.3 



Initial con(ditions 



The Initial Conditions are a set of general prerequisites for the (U)SIM prior to the execution of testing. For each test 
procedure described in the present document, the following rules apply to the Initial Conditions: 

• unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages 
specific to other test procedures shall not be present. 

Prior to any test the test environment shall have the (U)SIM powered on and performed the PROFILE DOWNLOAD 
procedure. 



5.4 Package name 



Java packages integrating this Test Suite shall follow this naming convention: 

uicc.scws.test.[Test Area Reference]: Java Card packages containing Test Area References for the TS 102 588 [2] 
uicc.scws package. 

uicc.scws.test.scwsframework.[Test Area Reference]: Java Card packages containing Test Area References for the 
TS 102 588 [2] SCWS Framework. 

uicc.scws.test.util: for the Test util package defined in this Test Suite. Requires package uicc.test.util from 
TS 102 268 [9]. 

where the Test Area Reference is written in lower case. 

EXAMPLE: The package ../uicc.scws.test.[Test Area Reference] creates the following directory structure 
../uicc/scws/test/[Test Area Reference]/Api_l _..._[! ..n] .*, where Api_l_..._[l..n].'*' are the 
different test applets Java source files used in [Test Area Reference] . 



5.5 AID coding 



The AID coding for the Test Packages, Applet classes and Applets shall be as specified in TS 101 220 [10]. In addition, 
the following TAR and Application Provider specific data values are defined for use within the present document: 

AID coding 




Byte 12 | Byte 13 | Byte 14 | Byte 15 | Byte 16 



Application Provider specific data 



TAR 



Specified in TS 101 220 [10] 
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TAR coding (3 bytes/ 24 bits): 



1 b1 1 


1 b4 1 b5 1 


1 b8 1 b9 1 


b12|b13| 


|b16|b17| 


|b24| 
























1 


Applet instance number 




Applet class number 










Package number 












RFU 














Test Part Identifier 



Applet instance number, Applet Class number, Package number: 

• For package AID, package number shall start from and class and instance numbers shall be 0. 

• For class AID, package number is the number of the class package, class number shall start from 1 and 
instance shall be 0. 

• For instance AID, package and class number are the number of class and package of which instance belongs, 
and instance number shall start from 1. 

Test part Identifier (bits bl-b4): 

• 0000 reserved (as TAR= '00.00.00' is reserved for Issuer Security Domain). 

• 00 1 API uicc . sc ws . 

• 0101 sews Framework. 

• other values are RFU. 
Application Provider specific data (1 byte): 

• '00' for Package. 

• 'Or for Applet class. 

• '02' for Applet Instance. 

EXAMPLE: The AID of Package uicc.scws is 'AO 00 00 00 87 10 05 FF FF FF FF 89 20 00 00 00'. 



5.6 Test equipment 



These clauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

5.6.1 Test tool 

This test tool shall meet the following requirements: 

• be able to send and receive HTTP messages to the SCWS in the UICC; 

• the result of I/O commands must be presented at the application layer; 

• be able to provide results of the tests; 

• shall send and/or compare all HTTP messages specified in the test files. 
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5.6.2 Interfaces ancJ classes use 

The sews test tool extends the UICC test tool defined in TS 102 268 [9]. Therefore the SCWS test tool cannot be run 
without having implemented the UICC test tool. 

The sews test tool shall use the interfaces and classes as defined in Annex C. They define the only allowed methods to 
write the test sources. 



Inte 



faces and classes are defined as follow: 

ScwsApplicationManagementService defines methods to manage applications; 

ScwsCardManagementService defines methods to manage the UICC; 

ScwsToolkitService defines methods to manage toolkit commands; 

ScwsHttpManagement defines methods to send and receive HTTP messages; 

ScwsAPITestCardService defines the static method to get a reference of the class implementing all interfaces. 

5.6.3 Util package 

Annex C includes Java source code of TestScwsApplet abstract class of the uicc.scws package. Each test applet shall 
extend this abstract class in order to retrieve test results when selecting it. 

5.6.4 Java Software Development Kit 

Java Card^"^ software development kit (SDK) version supported by Java Card 2.2.2 specifications ([6], [7], [8]) is 1.4.1. 

6 Test Cases 

6.1 class uicc.scws 

6.1.1 Class ScwsExtensionRegistry 

6.1.1.1 Method register 

Test Area Reference: API_l_Ser_Regi. 

6.1.1.1.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

static void register {ScwsExtension scwsExtension, 
byte [] appid, 
short offset, 
short length) 
throws Java. lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 
ScwsException 

6.1.1.1.1.1 Normal execution 

• CRRNl: registers the scwsExtension object to the SCWS. 
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6.1.1.1.1.2 Parameter Errors 

• CRRPl: if scwsExtension is null, a NullPointerException is thrown. 

• CRRP2: if appld is null, a NullPointerException is thrown. 

• CRRP3: if offset or length or both would cause access outside of the array bounds, or if length is negative an 
ArraylndexOutOfBoundsException is thrown. 



6.1.1.1.1.3 



Context errors 



• CRRCl: if the appld is already registered, an ScwsException with reason code 
SCWSEXTENSION_REGISTRY_ERROR is thrown. 



6.1.1.1.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.1.1.3 



Test_Api_l_Ser_Regi.java. 
Api_l_Ser_Regi_l .Java. 
Api_l_Ser_Regi.cap. 



Test coverage 



CRR number 


Test case number 


N1 


8 


PI 


1 


P2 


2 


P3 


3, 4, 5, 6, 7 


01 


9, 10 



6.1.1.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 





Instanciate an object implementing 
the scwsExtension interface 






1 


Null scwsExtension 

register { ) 


NullPointerException is thrown 




2 


Null appld 

register { ) 


NullPointerException is thrown 




3 


offset > appld.length 

register { ) 
appld.length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsException is thrown 




4 


Offset < 

register { ) 
appld.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsException is thrown 




5 


length > appld.length 

register { ) 
appld.length = 5 
offset = 
length = 6 


ArraylndexOutOfBoundsException is thrown 




6 


Offset + length > appld.length 

register { ) 
appld.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsException is thrown 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


7 


length < 

register { ) 
appld. length = 5 
offset = 
length = -1 


ArraylndexOutOfBoundsException is thrown 






register the object implementing the 
scwsExtension interface with the 
name "Namel" to the SCWS . 






8 


successful registration 

register { ) 

appld = (byte) 'N', (byte) 'a', 

(byte) 'm', (byte) 'e', (byte) '1' 

offset = 

length = 5 








register the same object a second 
time with the same name 






9 


unsuccessful registration 

register { ) 

appld = (byte) 'N', (byte) 'a', 

(byte) 'm', (byte) 'e', (byte) '1' 

offset = 

length = 5 


ScwsException with reason code 
SCWSEXTENSION_REGISTRY_ERROR is thrown 






retrieve a second object 
implementing the scwsExtension 
interface 






10 


register different object with the same 
appld 

register { ) 

appld = (byte) 'N', (byte) 'a', 

(byte) 'm', (byte) 'e', (byte) '1' 

offset = 

length = 5 


ScwsException with reason code 
SCWSEXTENSION_REGISTRY_ERROR is thrown 





6.1.1.2 Method deregister 

Test Area Reference: API_l_Ser_Dreg, Api_l_Ser_Dreg_Helper 

6.1.1.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

static void deregister {ScwsExtension scwsExtension) 

throws Java . lang.NullPointerException, 
ScwsException, 
j ava . lang . SecurityException 

6.1.1.2.1.1 Normal execution 

• CRRNl: deregisters the scwsExtension object from the SCWS. 

6.1.1.2.1.2 Parameter Errors 

• CRRPl: if scwsExtension is null, a NullPointerException is thrown. 

6.1.1.2.1.3 Context errors 

• CRRCl : if the scwsExtension was not registered before, an ScwsException with reason code 
SCWSEXTENSION_REGISTRY_ERROR is thrown. 

• CRRC2: if the scwsExtension was previously registered by a different JCRE context than it is used for the 
deregistration, a Java. lang. SecurityException shall be thrown. 

• CRRC3: if the scwsExtension was already deregistered, an ScwsException with reason code 
SCWSEXTENSION_REGISTRY_ERROR is thrown. 
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Test Source: 




Test_ Api_l_Ser_Dreg.java. 


Test Applet: 




Api_l_Ser_Dreg_l .Java. 
Api_l_Ser_Dreg_Helper.java. 


Cap File: 




Api_l_Ser_Dreg.cap. 


Cap File: 




Api_l_Ser_Dreg_Helper.cap. 


6.1.1.2.3 


Test 


coverage 



CRR number 


Test case number 


N1 


3 


P1 


2 


C1 


1 


C2 


5 


C3 


4 



6.1.1.2.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 





Instanciate an object implementing 
the scwsExtension interface. 






1 


No previous registration 

deregister 


ScwsException with reason code 
SCWSEXTENSION REGISTRY ERROR is thrown 






Register the object to the SCWS 






2 


Null scwsExtension 

deregister { ) 
scwsExtension = null 


NullPointerException is thrown 




3 


Succesful deregistration 

deregister { ) 






4 


Second deregistration 

deregister { ) 


ScwsException with reason code 
SCWSEXTENSION REGISTRY ERROR is thrown 




5 


Different context 

Request the SCWSExtension object 
from a different context and 
deregister it. 


java.lang.SecurityException is thrown 





6.1.2 Interface ScwsExtension 

This interface is implicitely tested by the tests covering the SCWSExtensionService. 

6.1.3 Class ScwsExtensionService 
6.1.3.1 Method doDelete 

Test Area Reference: Api_l_Ses_Ddel. 

6.1 .3.1 .1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doDelete {HttpRequest request, 

HttpResponse response) 
throws ScwsException 
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Normal execution 



Parameter Errors 



Context errors 



• CRRCl : if a ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the application 
then an appropriate HTML status page is returned by the SCWS (status code 5xx, 4xx). 

6.1.3.1.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.1.3 



Test_Api_l_Ses_Ddel.java. 
Api_ 1 _Ses_Ddel_ 1 .j ava. 
Api_l_Ses_Ddel.cap. 



Test coverage 



CRR number 


Test case number 


01 


1 



6.1.3.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doDeleteScwsExtensionServiceObject object and 
register to the SCWS. Map the object to the path 

"/Test Api 1 Ses Ddel" in the SCWS and send a HTTP Delete request 
to the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by the 
SCWS 



6.1.3.2 Method doGet 

Test Area Reference: Api_l_Ses_Dget. 

6.1.3.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doGet {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.2.1.1 
• n/a. 



Normal execution 
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Parameter Errors 



Context errors 



• CRRCl : if an ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the 
application then an appropriate HTML status page is returned by the SCWS (status code 4xx, 5xx). 

6.1.3.2.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.2.3 



6.1.3.2.4 



Test_Api_l_Ses_Dget.java. 

Api_l_Ses_Dget_l.java. 

Api_l_Ses_Dget.cap. 



Test coverage 



CRR number 


Test case number 


CI 


1 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doGetScwsExtensionServiceObject object and 
register to the SCWS. Map the object to the path 

"/Test Api 1 Ses Dget" in the SCWS and send a HTTP Get request to 
the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by tine 
SCWS 



6.1.3.3 Method doHead 

Test Area Reference: Api_l_Ses_Dhea. 

6.1.3.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doHead {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.3.1.1 

• n/a. 

6.1.3.3.1.2 

• n/a. 



Normal execution 



Parameter Errors 
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6.1.3.3.1.3 



Context errors 



• CRRCl : if an ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the 
appHcation then an appropriate HTML status page is returned by the SCWS (status code 4xx, 5xx). 

6.1.3.3.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.3.3 



Test_Api_l_Ses_Dhea.java. 

Api_l_Ses_Dhea_l.java. 

Api_l_Ses_Dhea.cap. 



Test coverage 



CRR number 


Test case number 


CI 


1 



6.1.3.3.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doHeadScwsExtensionServiceObject object and 
register to the SCWS. Map the object to the path 
"/Test_Api_l_Ses_Dhea" in the SCWS and send a HTTP Head request 
to the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx ) is 
returned by tlie 
SCWS 



6.1 .3.4 Method doOptions 

Test Area Reference: Api_l_Ses_Dopt. 

6.1.3.4.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doOptions {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.4.1.1 

• n/a. 

6.1.3.4.1.2 

• n/a. 

6.1.3.4.1.3 



Normal execution 



Parameter Errors 



Context errors 



CRRCl: if a ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the application 
(which is Intercept or Non Intercept Application ) then an appropriate HTML status page is returned by the 
SCWS (status code 4xx, 5xx). 
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Test Source: 
Test Applet: 
Cap File: 

6.1.3.4.3 



Test_Api_l_Ses_Dopt.java. 
Api_ 1 _Ses_Dopt_ 1 .j ava. 
Api_l_Ses_Dopt.cap. 



Test coverage 



CRR number 


Test case number 


C1 


1 



6.1.3.4.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doOptionsScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 
"/Test Api 1 Ses Dopt" in the SCWS and send a HTTP Options 
request to the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by the 
SCWS 



6.1.3.5 Method doPost 

Test Area Reference: Api_l_Ses_Dpos. 

6.1.3.5.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doPost {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.5.1.1 

• n/a. 

6.1.3.5.1.2 

• n/a. 

6.1.3.5.1.3 



Normal execution 



Parameter Errors 



Context errors 



• CRRCl : if an ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the 
application then an appropriate HTML status page is returned by the SCWS (status code 4xx, 5xx). 

6.1.3.5.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Ses_Dpos.java. 

Test Applet: Api_l_Ses_Dpos_l.java. 
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Api_l_Ses_Dpos.cap. 

Test coverage 



CRR number 


Test case number 


C1 


1 



6.1.3.5.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doPostScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 
"/Test_Api_l_Ses_Dpos" in the SCWS and send a HTTP Post request 
to the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by tine 
SCWS 



6.1.3.6 Method doPut 

Test Area Reference: Api_l_Ses_Dput. 

6.1.3.6.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doPut {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.6.1.1 

• n/a. 

6.1.3.6.1.2 

• n/a. 

6.1.3.6.1.3 



Normal execution 



Parameter Errors 



Context errors 



• CRRCl : if a ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the application 
(which is Intercept or Non Intercept Application) then an appropriate HTML status page is returned by the 
SCWS (status code 4xx, 5xx). 

6.1.3.6.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Ses_Dput.java. 

Test Applet: Api_l_Ses_Dput_l.java. 

Cap File: Api_l_Ses_Dput.cap. 
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Test coverage 



CRR number 


Test case number 


C1 


1 



6.1.3.6.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doPutScwsExtensionServiceObject object and 
register to the SCWS . Map the object to the path 

"/Test_Api_l_Ses_Dput" in the SCWS and send a HTTP Put request to 
the SCWS triggering the application. 






1 


Throw ScwsExceptlon with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx ) is 
returned by the 
SCWS 



6.1.3.7 Method doTrace 

Test Area Reference: Api_l_Ses_Dtra. 

6.1.3.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void doTrace {HttpRequest request, 

HttpResponse response) 
throws ScwsException 



6.1.3.7.1.1 

• n/a. 

6.1.3.7.1.2 

• n/a. 

6.1.3.7.1.3 



Normal execution 



Parameter Errors 



Context errors 



• CRRCl : if a ScwsException with reason code METHOD_NOT_SUPPORTED was thrown by the application 
(which is Intercept or Non Intercept Application ) then an appropriate HTML status page is returned by the 
SCWS (status code 4xx, 5xx). 

6.1.3.7.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.3.7.3 



Test_Api_l_Ses_Dtra.java. 
Api_l_Ses_Dtra_l .Java. 
Api_l_Ses_Dtra.cap. 



Test coverage 



CRR number 


Test case number 


C1 


1 
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6.1.3.7.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 





Instantiate an doTraceScwsExtensionServiceObject object and 
register to the SCWS. Map the object to the path 

"/Test Api 1 Ses Dtra" in the SCWS and send a HTTP Trace request 
to the SCWS triggering the application. 






1 


Throw ScwsException with reason code METHOD_NOT_SUPPORTED 




Appropriate status 
code (4xx, 5xx) is 
returned by the 
SCWS. 



6.1.4 Interface HttpRequest 

6.1.4.1 Method findAndCopyKey word Value 

Test Area Reference: Api_l_Hrq_Fckw. 



6.1.4.1.1 



Conformance Requirement 



The method with following header shall be compliant to its definition in the API. 

short f indAndCopyKeywordValue {byte [] headerKeywordName , 

short nameOffs, 
short nameLength, 
byte [] buffer, 
short bufferOffs, 
short maxLength) 
throws : Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException. 

6.1 .4.1 .1 .1 Normal execution 

• CRRN 1 : Find and copy the value of a header. 

• CRRN2: bufferOffs+length of the copied value or KEYWORD_NOT_FOUND in case the keyword is not 
found. 

6.1.4.1.1.2 Parameter Errors 

• CRRPl: if headerKeywordName is equal to null a java.lang.NullPointerException is thrown. 

• CRRP2: if buffer is equal to null a NullPointerException is thrown. 

• CRRP3: if the copy operation would cause access out of bounds an ArraylndexOutOfBoundsException is 
thrown. 



6.1.4.1.1.3 
• n/a. 



Context errors 



6.1.4.1.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Hrq_Fckw_Bss_Bss.java. 

Test Applet: Api_l_Hrq_Fckw_Bss_Bss_l.java. 

Cap File: Api_l_Hrq_Fckw_Bss_Bss.cap. 
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Test coverage 



CRR number 


Test case number 


P1 


1 


P2 


2 


P3 


3, 4, 5, 6, 7 


N1 


9 


N2 


8 



6.1.4.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


findAndCopyKeywordValue () with a null 
headerKeywordName 


NullPointerException is thrown 




2 


findAndCopyKeywordValue () with a null buffer 


NullPointerException is thrown 




3 


bufferOffs > buffer.length 

findAndCopyKeywordValue () 
nameOffs = 
buffer.length = 2 
bufferOffs = 2 
maxLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




4 


bufferOffs < 

findAndCopyKeywordValue ( ) 
buffer.length = 2 
bufferOffs = -1 
maxLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




5 


maxLength > buffer.length 

findAndCopyKeywordValue ( ) 
buffer.length = 2 
bufferOffs = 
maxLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


bufferOffs + maxLength > buffer.length 

findAndCopyKeywordValue ( ) 
buffer.length = 2 
bufferOffs = 1 
maxLength = 2 


ArraylndexOutOfBoundsException is 
thrown 




7 


maxLength < 

findAndCopyKeywordValue ( ) 
buffer.length = 2 
bufferOffs = 
maxLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




8 


findAndCopyKeywordValue ( ) 

headerKeywordName= HEADER AB [ This header is 
not present in the request] 
bufferOffs = 


ScwsGonstants.KEYWORD NOT FOU 
ND 




9 


findAndCopyKeywordValue ( ) 

headerKeywordName= HEADER AB [ This header is 
present in the request] 
bufferOffs = 1 


lenght of Header AB (1) + bufferOffs (1) 
= 2 





6.1 .4.2 Method findAndCopyKeywordValue 

Test Area Reference: Api_l_Hrq_Fckw. 
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6.1.4.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short findAndCopyKeywordValue {short keywordid, 

byte [] buffer, 
short bufferOffs, 
short maxLength) 
throws ScwsException, 

NullPointerException, 
ArraylndexOutOfBoundsException 



6.1.4.2.1.1 



Normal execution 



• CRRNl Find and copy the value of a header or the value of a keyword/value part of the URI indicated by a 
keywordid. The supported keywords are defined in ScwsConstants Interface. 

6.1 .4.2.1 .2 Parameter Errors 

• CRRPl KEYWORD_NOT_FOUND in case the keyword is not found. 

• CRRP2 if the keywordid is not recognized a ScwsException - with reason UNKNOWN_KEYWORD_ID. 

• CRRP3: if buffer is equal to null a NullPointerException is thrown. 

• CRRP4: if the copy operation would cause access out of bounds an ArraylndexOutOfBoundsException is 
thrown. 



6.1.4.2.1.3 
• n/a. 



Context errors 



6.1.4.2.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.4.2.3 



Te s t_ Api_ 1 _Hrq_Fckws_B s s . j a va . 
Api_l_Hrq_Fckws_Bss_l .Java. 
Api_l_Hrq_Fckws_Bss.cap. 



Test coverage 



CRR number 


Test case number 


P1 


1 


P2 


2 


P3 


19 


P4 


20,21,22,23,24 


N1 


3,4,5,6,7,8,9, 10, 11, 
12, 13, 14, 15, 16, 17, 18 
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6.1.4.2.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_ACCEPT_ENCODING 
[not present in request] 
bufferOffs = 


ScwsConstants.KEYWORD_NOT_FOUND 




2 


f IndAndCopyKeywordValue { ) 
keywordid = 99 (Unknown) 
bufferOffs = 


ScwsException - with reason 

U]SrK]SrOWN_KE YWORD_I D 




3 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .HEADER_ACCEPT 
[present in request] 
bufferOffs = 






4 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_ACCEPT_CHARSET 
[present in request] 
bufferOffs = 






5 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_ACCEPT_ENCODING 
[present in request] 
bufferOffs = 






6 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_ACCEPT_LANGUAGE 
[present in request] 
bufferOffs = 






7 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .HEADER HOST 
[present in request] 
bufferOffs = 






8 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_USER_AGENT 
[present in request] 
bufferOffs = 






9 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_CONTENT_ENCODING 
[present in request] 
bufferOffs = 






10 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_CONTENT_LANGUAGE 
[present in request] 
bufferOffs = 






11 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_CONTENT_LENGTH 
[present in request] 
bufferOffs = 






12 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_CONTENT_TYPE 
[present in request] 
bufferOffs = 






13 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .HEADER_SERVER 
[present in request] 
bufferOffs = 






14 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .URI_TAG 
[present in request] 
bufferOffs = 






15 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .URI_SCHEMA_TAG 
[present in request] 
bufferOffs = 






16 


f indAndCopyKeywordValue { ) 

keywordid = ScwsConstants .URI_AUTHORITY_TAG 
[present in request] 
bufferOffs = 






17 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .URI_PATH_TAG 
[present in request] 
bufferOffs = 






18 


f indAndCopyKeywordValue { ) 
keywordid = ScwsConstants .URI_QUERY_TAG 
[present in request] 
bufferOffs = 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


19 


f indAndCopyKeywordValue { ) with a null buffer 


NullPointerException is thrown 




20 


bufferOffs > buffer.length 

f IndAndCopyKeywordValue {) 
buffer.length = 2 
bufferOffs = 3 
maxLength = 1 


ArraylndexOutOfBoundsException is 
tlirown 




21 


bufferOffs < 

f IndAndCopyKeywordValue { ) 
buffer.length = 2 
bufferOffs = -1 
maxLength = 1 


ArraylndexOutOfBoundsException is 
thrown 




22 


maxLength > buffer.length 

f IndAndCopyKeywordValue { ) 
buffer.length = 2 
bufferOffs = 
maxLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




23 


bufferOffs + maxLength > buffer.length 

f IndAndCopyKeywordValue { ) 
buffer.length = 2 
bufferOffs = 1 
maxLength = 2 


ArraylndexOutOfBoundsException is 
thrown 




24 


maxLength < 

f IndAndCopyKeywordValue { ) 
buffer.length = 2 
bufferOffs = 
maxLength = -1 


ArraylndexOutOfBoundsException is 
thrown 





6.1.4.3 Method getContentLength 

Test Area Reference: Api_l_Hrq_Gcle. 

6.1.4.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

int getContentLength { ) 

6.1.4.3.1.1 Normal execution 

• CRRNl : Returns the length of the HTTP request content. 

6.1 .4.3.1 .2 Parameter Errors 

• None. 



6.1.4.3.1.3 
• None. 



Context errors 



6.1.4.3.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Hrq_Gcle.java. 

Test Applet: Api_l_Hrq_Gcle_l.java. 

Cap File: Api_l_Hrq_Gcle.cap. 
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Test coverage 



CRR number 


Test case number 


N1 


1,2 



6.1.4.3.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 


1 


Normal execution 

Send a HTTP request of OxFF bytes. 


getContentLenghtQ 
returns Oxff 




2 


Normal execution 

Send a HTTP request of 0x00 bytes. 


getContentLenghtO 
returns Oxoo 




NOTE: Tests regarding the upper boundaries of the HTTPRequest buffer can not be performed since a minimum size 
of the request buffer is not specified. 



6.1 .4.4 Method getContentType 

Test Area Reference: Api_l_Hrq_Gcty. 

6.1.4.4.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short getContentType { ) 

6.1 .4.4.1 .1 Normal execution 

• CRRN 1 : Returns the content-type keyword of the HTTP request or an appropriate error code. 

6.1 .4.4.1 .2 Parameter Errors 

• None. 



6.1.4.4.1.3 
• None. 



Context errors 



6.1 .4.4.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.4.4.3 



Test_Api_ 1 _Hrq_Gcty .j ava. 
Api_l_Hrq_Gcty_l .Java. 
Api_ 1 _Hrq_Gcty . c ap . 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 
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6.1.4.4.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


Normal execution 

Send a HTTP request with content type set to: 
text/html. 


Returns 
ScwsConstants.CONTENT_TYPE_TEXT_HTML 




2 


Normal execution 

Send a HTTP request with content type set to: 
text/plain. 


Returns 
ScwsConstants.CONTENT_TYPE_TEXT_PLAIN 




3 


Keyword not found 

Send a HTTP request with content type header 
field missing 


Returns 
ScwsConstants.KEYWORD_NOT_FOUND 




4 


Content type unknown 

Send a HTTP request with content type which 
doesn't match one of the possible contents 


Returns 
ScwsConstantS.CONTENT_TYPE_UNKNOWN 





6.1 .4.5 Method getRequestHttpVersion 

Test Area Reference: Api_l_Hrq_Grhv. 

6.1.4.5.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short getRequestHttpVersion { ) 

6.1 .4.5.1 .1 Normal execution 

• CRRNl : Returns the version of the HTTP protocol of the current request. 

6.1 .4.5.1 .2 Parameter Errors 

• None. 



6.1.4.5.1.3 
• None. 



Context errors 



6.1.4.5.2 Test area files 

Specific triggering: Unrecognized envelope: 



Test Source: 
Test Applet: 
Cap File: 

6.1.4.5.3 



Test_Api_ 1 _Hrq_Grhv.j ava. 
Api_l_Hrq_Grhv_l .Java. 
Api_l_Hrq_Grhv.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2 
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6.1.4.5.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


Normal execution 

Send a HTTP request with protocol version 
set to: HTTP/1.0. 


Returns 
ScwsConstants.HTTP_PROTOCOL_VERSION_10 




2 


Normal execution 

Send a HTTP request with protocol version 
set to: HTTP/1.1. 


Returns 
ScwsConstants.HTTP_PROTOCOL_VERSION_11 





6.1.4.6 Method readContent 

Test Area Reference: Api_l_Hrq_Rcon. 

6.1.4.6.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short readContent {int requestOf f set , 
byte [] data, 
short offset, 
short len) 
throws: ScwsException 

Java . lang.NulPointerException 

Java . lang. ArraylndexOutOfBoundsException 

6.1.4.6.1.1 Normal execution 

• CRRN 1 : Read a part of the request content and copy it in the data buffer. 

6.1 .4.6.1 .2 Parameter Errors 

• CRRPl: if the data buffer is equal to null, a java.lang.NuU PointerException is thrown. 

• CRRP2: if the copy operation would cause access out of bounds, a 
java.lang./^aylndexOutOfBoundsException will be thrown. 

• CRRP3: if the requested offset is out of the request bounds, a ScwsException.UNREACHABLE_OFFSET 
will be thrown. 



6.1.4.6.1.3 
• None. 



Context errors 



6.1.4.6.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Hrq_Rcon.java. 

Test Applet: Api_l_Hrq_Rcon_l.java. 

Cap File: Api_l_Hrq_Rcon.cap. 
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Test coverage 



CRR number 


Test case number 


N1 


1,2 


P1 


3 


P2 


4, 5, 6, 7, 8 


P3 


9, 10 



6.1.4.6.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


1 


Normal execution 

Send a request with Content-length set to 

0x2 

readContent { ) 

requestOf f set = 

offset = 

len = 0x10 


Data buffers contains the first bytes of the 
request content 




2 


Normal execution 

Send a request with Content-length set to 

0x2 

readContent { ) 

requestOf f set = 

offset = 

len = 0x2 


Data buffers contains the entire request content 




3 


Null pointer exception 

Send a request with Content -length set to 

0x2 

readContent { ) 

data[] is set to null 


NullPointerException is thrown 




4 


offset > data.length 

Send a request with Content-length set to 

0x2 

readContent { ) 

data.length = 0x20 

offset = 0x20 

length = 0x10 


ArraylndexOutOfBoundException is thrown 




5 


length > data.length 

Send a request with Content-length set to 

0x2 

readContent { ) 

data.length = OxlF 

offset = 0x00 

length = 0x2 


Array! ndexOutOfBound Exception is thrown 




6 


offset + length > data.length 

Send a request with Content-length set to 

0x2 

readContent { ) 

data.length = 0x2 

offset = 0x10 

length = 0x11 


ArraylndexOutOfBoundException is thrown 




7 


length < 

Send a request with Content-length set to 

0x2 

readContent { ) 

data.length = 0x2 

offset = 0x00 

length = -1 


ArraylndexOutOfBoundException is thrown 




8 


Offset < 

Send a request with Content -length set to 

0x2 

readContent { ) 

data.length = 0x2 

offset = -1 

length = 0x10 


ArraylndexOutOfBoundException is thrown 





£75/ 



(Release 7) 



36 



ETSI TS 102 835 V7.1.0 (2010-10) 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP 
Expectation 


9 


requestOffset > request lengtli 

Send a request with Content-length set to 

0x2 

readContent { ) 

Request length is 0x2 

requestOffset = 0x20 

data. length = 0x2 

offset = 

length = 0x10 


ScwsException.UNREACHABLE_OFFSETis 
thrown 




10 


requestOffset < 

Send a request with Content-length set to 

0x2 

readContent { ) 

Request length is 0x2 

requestOffset = -1 

data. length = 0x2 

offset = 

length = 0x10 


ScwsException.UNREACHABLE_OFFSETis 
thrown 





6.1.4.7 Method readContentType 

Test Area Reference: Api_l_Hrq_Rcty. 

6.1.4.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

short readContentType {byte [] data, 
short offs, 
short len) 
throws : Java . lang.NulPointerException 

j ava . lang . ArraylndexOutOf BoundsException 



6.1.4.7.1.1 



Normal execution 



• CRRNl: Reads the content type given in the HTTP request and copy it in the data[ ] buffer. Returns the offset 
of the last data written in the buffer. 



6.1 .4.7.1 .2 Parameter Errors 

• CRRPl: if the data buffer is null, a java.lang.NullPointerException will be thrown. 

• CRRP2: if the copy operation would cause access out of bounds, a 
java.lang.ArraylndexOutOfBoundsException will be thrown. 



6.1.4.7.1.3 
• None. 



Context errors 



6.1.4.7.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_l_Hrq_Rcty.java. 

Test Applet: Api_l_Hrq_Rcty_l.java. 

Cap File: Api_l_Hrq_Rcty.cap. 
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Test coverage 



CRR number 


Test case number 


N1 


1,2 


P1 


3 


P2 


4, 5, 6, 7, 8 



6.1.4.7.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP 
Expectation 


1 


Normal execution 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data. length = 0x20 
offs = 0x00 
len = OxOA 


text/html is written in the data 
buffer and tlie method returns 
0x08 




2 


Normal execution 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data. length = 0x20 
offs = 0x00 
len = 0x05 


text/ is written in the data buffer 
and the method returns 0x04 




3 


Null pointer 

Send a HTTP request with content type set to: text/html 
readContentType { ) 
data = null 
offs = 0x00 
len = OxOA 


NullPointerException is thrown 




4 


Offs > data.length 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data.length = 0x20 
offs = 0x20 
len = 0x10 


ArraylndexOutOfBoundException 
is thrown 




5 


len > data.length 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data.length = 0x05 
offs = 0x00 
len = 0x09 


ArraylndexOutOfBoundException 
is thrown 




6 


Offs + len > data.length 

Send a HTTP request with content type set to: text/html. 
readContentType { ) 
data.length = 0x0 5 
offs = 0x01 
len = 0x05 


ArraylndexOutOfBoundException 
is thrown 




7 


len < 

Send a HTTP request with content type set to: text/html. 
readContent { ) 
data.length = 0x20 
offs = 0x00 
Len = -1 


ArraylndexOutOfBoundException 
is thrown 




8 


Offs < 

Send a HTTP request with content type set to: text/html. 
readContent { ) 
data.length = 0x20 
offs = -1 
Len = 0x10 


ArraylndexOutOfBoundException 
is thrown 
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6.1.5 Interface HttpResponse 

6.1.5.1 Method appendContent 

Test Area Reference: Api_l_Hrs_Acon. 

6.1 .5.1 .1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void appendContent {byte [] data, 
short offset, 
short length) 
throws ScwsException 

6.1.5.1.1.1 Normal execution 

• CRRNl: Writes the content of data into the HttpResponse. 

• CRRN2: Invoking this method implicitly finalizes the header of the HttpResponse. 

• CRRN3: In case of chunked transfer encoding hex length of chunked data is automatically added by the 
framework. 

6.1.5.1.1.2 Parameter Errors 

• CRRPl: if data is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if parameter offset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if parameter length is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP4: if parameter offset plus length are greater than the length of array data, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

6.1.5.1.1.3 Context errors 

• CRRCl : if appending the content would cause an overflow of the response buffer, a uicc. sews. ScwsException 
with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC2: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC3: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.1.2 Test area files 

Specific triggering: None: 

Test Source: Test_Api_l_Hrs_Acon.java. 

Test Applet: Api_l_Hrs_Acon _1 .Java. 

Cap File: Api_l_Hrs_Acon.cap. 
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Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5, 14 


N2 


4 


N3 


2, 14 


P1 


6 


P2 


7 


P3 


8 


P4 


9 


C1 


12, 13 


C2 


10 


C3 


11 



6.1.5.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


append chunk off 

writeStatusCode (200) 
f inalizeHeader { ) 

appendContent { 
data = [Hello World] 
offset = 
length = 6) 

appendContent { 
data = [Hello World] 
offset = 6 
length = 5) 

flush {) 




HTTPResponse { 
statusCode = "200" 
Header {"Content-Length" ) = "11" 
contentBody = "Hello World" 

) 


2 


append chunk on 

writeStatusCode (200) 
enableChunlcMode { ) 
f inalizeHeader { ) 

appendContent { 

data = [Hello World] 

offset = 

length = 6) 
appendContent { 

data = [Hello World] 

offset = 6 

length = 5) 

flush {) 




HTTPResponse { 

StatusCode = "200" 

Header {"Transfer-Encoding" ) = 
"chunked" 

contentBody = "Hello World" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


3 


append up to remaining 
buffer length 

writeStatusCode (200) 
f inalizeHeader { ) 

appendContent { 
data = 'aaa . . . ' 
offset = 
length = 

remainingBuf f erLength) 

flush {) 




HTTPResponse { 
StatusCode = "200" 
Header {"Content-Length") = 

bufferLength 

contentBody = "aaa..." 
) 


4 


append implicitly finalizes 
the header 

writeStatusCode (200) 

appendContent { 
data= [Hello World] 
offset= 
length= 11) 

flush {) 




HTTPResponse { 
StatusCode = "200" 
Header {"Content-Length") = "11" 
contentBody = "Hello World" 

) 


5 


length = 

writeStatusCode (200) 
f inalizeHeader { ) 

appendContent { 
data = [Hello World] 
offset= 
length= 0) 

flush {) 




HTTPResponse { 

StatusCode = "200" 

Header {"Content -Length") = "0" 

contentBody = " " 
) 


6 


data[] is null 

appendContent { 
data= null 
offset = 
length = 10) 


java.lang.NullPointerException is thrown : 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


7 


offset<0 

appendContent { 
data = [Hello World] 
offset = -1 
length = 10) 


java.lang.ArraylndexOutOfBoundsExceptio 
n is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


8 


length<0 

appendContent { 
data = [Hello World] 
offset = 
length = -1) 


Java. lang.ArraylndexOutOf BoundsExce 
ption is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 
StatusCode = "204" 

) 


9 


Offset + length > data.length 

appendContent { 
data = [Hello World] 
offset = 10 
length = 11) 


Java. lang.ArraylndexOutOf BoundsExce 
ption is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


10 


flush called previously 

writeStatusCode (200) 
f inalizeHeader { ) 
appendContent { 

data = 'Hello' 

offset = 

length = 5) 
flush 

appendContent { 
data = 'World' L 
offset = 
length =5) 


uicc . sews .ScwsException with reason 
' codes HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

statusCode = "200" 

Header { "Content-Length" ) = "5" 

contentBody = "Hello" 
) 


11 


sendError called previously 

sendError (500) 

appendContent { 
data = 'World' 
offset =0 r 
length = 5) 


uicc . sews . ScwsException with reason 
" codes HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

StatusCode = "500" 
) 


12 


response buffer overflow 

writeStatusCode (200) 
f inalizeHeader { ) 

appendContent ( 
data = 'aaa. . . ' 
offset =0 I 
length = 

responseBuf f er+1) 


uicc . sews . ScwsException with reason 
codes BUFFER_OVERFLOW iS thrown. 

Catch the exception and continue the 
procedure. 


HTTPResponse ( 
StatusCode = "200" 
Header {"Content-Length") = "0" 

contentBody = " " 
) 


13 


Void 






14 


Void 






15 


Not present 

writeStatusCode (200) 
f inalizeHeader { ) 
flush {) 




HTTPResponse { 
StatusCode = "200" 
Header {"Content-Length") = "0" 

ContentBody = "" 
) 



6.1 .5.2 Method appendHeaderVariable(byte[] data, short offset, short length) 

Test Area Reference: Api_l_Hrs_Ahva_Bss. 

6.1.5.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void appendHeaderVariable {byte [] data, 

short offset, 
short length) 
throws ScwsException 

6.1.5.2.1.1 Normal execution 

• CRRNl: Writes a header variable to outgoing buffer, "CRLF" will be appended automatically. 

• CRRN2: The header variables content-length or transfer-encoding are inserted by the framework depending on 
the transfer mode. 
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6.1.5.2.1.2 Parameter Errors 

• CRRPl: if data is null, a java.lang.NuUPointerException is thrown. 

• CRRP2: if parameter offset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if parameter length is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP4: if parameter offset plus length are greater than the length of array data, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 



6.1.5.2.1.3 



Context errors 



• CRRCl: if the HTTP header was already finalized, a uicc.scws.ScwsException with reason codes 
HEADER_ALREADY_FINALIZED is thrown. 

• CRRC2: if appending the header variable would cause an overflow of the response buffer, a 
uicc.scws.ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC3: if the flush method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC4; if the sendError method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.2.2 Test area files 

Specific triggering: None: 

Test Source: Test_ Api_l_Hrs_Ahva_Bss.java. 

Test Applet: Api_l_Hrs_Ahva_Bss_l.java. 

Cap File: Api_l_Hrs_Ahva_Bss.cap. 



6.1.5.2.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


N2 


1,2,3,4 


PI 


5 


P2 


6 


P3 


7 


P4 


8 


01 


9, 10 


C2 


11 


C3 


12 


C4 


13 



6.1.5.2.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Basic 

writeStatusCode (200) 

appendHeaderVariable { 
data= [A: B] , 
offset= 0, 
length= 4) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

StatusCode = "200" 

Header {"A") = "B" 

Header {"Content-Length" ) = "2" 

contentBody = "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


2 


offset>0 

writeStatusCode {200) 

appendHeaderVariable { 
data= [A: EC: Dd] , 
offset= 4, 
length= 5) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flusli{) ; 




HTTPResponse { 

statusCode= "200" 

Header {"C")= "Dd" 

Header { "Content-Length" ) = "2" 

contentBody= "OK" 
) 


3 


No SP char 

writeStatusCode {200) 

appendHeaderVariable { 
data= [A:B] , 
offset= 0, 
length= 3) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flusli{) ; 




HTTPResponse { 

statusCode= "200" 

Header { "A" )= "B" 

Header {"Content-Length" ) = "2" 

contentBody= "OK" 
) 


4 


length = 

writeStatusCode {200) 

appendHeaderVariable { 
data= [A: B] , 
offset = 0, 
length = 0) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 
statusCode= "200" 
Header { "Content -Length" ) = "2" 

contentBody= "OK" 
) 


5 


data[] is null 

appendHeaderVariable { 
data = null, 
offset = 0, 
length = 2) 


Java . lang.NullPointerException 
is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

statusCode = "204" 
) 


6 


offset<0 

appendHeaderVariable { 
data= [A: B] , 
offset= -1, 
length= 4) 


j ava . lang . ArraylndexOutOf Bounds 
Exception is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


7 


Length<0 

appendHeaderVariable { 
data = [A: B] , 
offset = 0, 
length = -1) 


j ava . lang . ArraylndexOutOf Bounds 
Exception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


8 


valueOffset + valueLength > 
value.length 

appendHeaderVariable { 
data = [A: B] , 
valueOffset= 1, 
length = 4) 


j ava . lang . ArraylndexOutOf Bounds 
Exception is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


9 


finallzeHeader called previously 

writeStatusCode (200) 
appendHeaderVariable { 

data = [A: B] , 

valueOffset= 0, 

length = 4) 




HTTPResponse { 
statusCode= "200" 






finallzeHeader { ) ; 




Header { "A" )= "B" 

Header { "Content -Length" ) = 


"2" 


appendHeaderVariable { 


Ulcc . sews . ScwsExceptlon with 




data = [C: D] , 1 


reason codes 


HeaderNotPresent {"C" ) 






valueOffset= 0, f 


HEADER_ALREADY_FINALIZED iS 


contentBody= "OK" 






length =4) J 


thrown. 

Catch the exception and continue the 

procedure. 


) 






appendContent { [OK] ,0,2) ; 










flush {) ; 








10 


appendContent called previously 

writeStatusCode (200) 

appendHeaderVariable { 
data = [A: B] , 
valueOffset= 0, 
length = 4) 




HTTPResponse { 
statusCode= "200" 
Header { "A" )= "B" 






appendContent { [OK] ,0,2) ; 




Header { "Content -Length" ) = 

HeaderNotPresent {"C" ) 


'2" 




appendHeaderVariable { "^ 


ulcc . sews . ScwsExceptlon with 


contentBody= "OK" 






data = [C: D] , 1 


reason codes 


) 






valueOffset= 0, f 


HEADER_ALREADY_FINALIZED iS 








length = 4) 


thrown. 

Catch the exception and 
continue the procedure. 








flush {) ; 








11 


BUFFER_OVERFLOW 


ulcc . sews . ScwsExceptlon with 


HTTPResponse ( 






writeStatusCode (200) 


reason codes BUFFER OVERFLOW is 


statusCode = "200" 






appendHeaderVariable { 


thrown. 


Header { "Content -Length" ) = 


"0" 




data = [A: BbB . . .] , 


Catch the exception and 


HeaderNotPresent { "A" ) 






valueOffset= 0, 


continue the procedure. 


). 






length = remalnlngBuf f erLength+1) 








12 


flush called previously 

writeStatusCode (200) 

appendHeaderVariable { 
data = [A: B] , 
valueOffset= 0, 
length = 4) 




HTTPResponse { 
statusCode= "200" 
Header { "A" )= "B" 






appendContent { [OK] ,0,2) ; 
flush {) ; 




Header { " Content - Length " ) = 

HeaderNotPresent {"C" ) 


"2" 






contentBody= "OK" 






appendHeaderVariable { "^ 


ulcc . sews . ScwsExceptlon with 


) 






data = [C: D] , 


reason codes 








valueOffset= 0, r 


HTTP_RESPONSE_ALREADY_SENT iS 








length = 4) 


thrown. 

Catch the exception and continue the 






13 




procedure. 






sendError called previously 










sendError (500) 




HTTPResponse { 






appendHeaderVariable ( "^ 
data = [A: B] , 


ulcc . sews . ScwsExceptlon with 
reason codes 


statusCode= "500" 
HeaderNotPresent { "A" ) 






valueOffset= 0, > 


HTTP_RESPONSE_ALREADY_SENT iS 


\ 






length = 4) 


thrown. 

Catch the exception and continue the 

procedure. 


1 
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6.1 .5.3 Method appendHeaderVariable (byteQ name, short nameOffset, short 

nameLength, byte[] value, short valueOffset, short valueLength) 

Test Area Reference: Api_l_Hrs_Ahva_Bss_Bss. 

6.1.5.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void appendHeaderVariable {byte [] name, 

short nameOffset, 
short nameLength, 
byte [] value, 
short valueOffset, 
short valueLength) 
throws ScwsException 

6.1.5.3.1.1 Normal execution 

• CRRNl: Appends a header variable to outgoing. The colon and space (":") as well as the "CRLF" will be 
appended automatically. 

• CRRN2: The header variables content-length or transfer-encoding are inserted by the framework depending on 
the transfer mode. 

6.1 .5.3.1 .2 Parameter Errors 

CRRPl: if name is null, a java.lang.NullPointerException is thrown. 

CRRP2: if value is null, a java.lang.NullPointerException is thrown. 

CRRP3: if parameter nameOffset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

CRRP4: if parameter nameLength is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

CRRP5: if parameter nameOffset plus nameLength are greater than the length of array name, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

CRRP6: if parameter valueOffset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

CRRP7: if parameter valueLength is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

CRRP8: if parameter valueOffset plus valueLength are greater than the length of array value, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

6.1.5.3.1.3 Context errors 

• CRRCl: if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER_ALREADY_FINALIZED is thrown. 

• CRRC2: if appending the header variable would cause an overflow of the response buffer, a 
uicc. sews. ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC3: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC4: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 
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6.1.5.3.2 Test area files 

Specific triggering: None: 

Test Source: Test_Api_l_Hrs_Ahva_Bss_Bss .Java. 

Test Applet: Api_l_Hrs_Ahva_Bss_Bss _l.java. 

Cap File: Api_l_Hrs_Ahva_Bss_Bss .cap. 



6.1.5.3.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


N2 


1,2,3,4,5 


P1 


6 


P2 


7 


P3 


8 


P4 


10 


P5 


12 


P6 


9 


P7 


11 


P8 


13 


C1 


14, 15 


C2 


16 


C3 


17 


C4 


18 



6.1.5.3.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Basic 

writeStatusCode (200) 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1 , 
value= [B] , 
value Offset= 0, 
value Length= 1) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "A" )= "B" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


2 


nameOffset>0 

writeStatusCode (200) 

appendHeaderVariable { 
name= [XAa] , 
nameOffset= 1, 
nameLength= 2 , 
value= [B] , 
value Offset= 0, 
value Length= 1) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header {"Aa")= "B" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


3 


valueOffset>0 

writeStatusCode (200) 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [XBb] , 
valueOffset= 1, 
valueLength= 2) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "A" )= "Bb" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


4 


nameLength = 

writeStatusCode (200) 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= , 
value= [B] , 
valueOffset= 0, 
valueLength= 1) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) 


When header name length is then 
nothing is append to the responseBuffer. 


HTTPResponse { 

statusCode= "200" 

Header { "Content -Length" ) = "2" 

contentBody= "OK" 

HeaderNotPresent { "A" ) 
) 


5 


valueLength = 

writeStatusCode (200) 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 
valueLength= 0) 

f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header {"Content-Length" ) = "2" 

Header { "A" )= "" 

contentBody= "OK" 
) 


6 


name[] is null 

appendHeaderVariable { 

name= null, 

nameOffset= 0, 

nameLength= 1 , 

value= [B] , 

value Offset= 0, 
value Length= 1 
) 


Java . lang.NullPointerException is 

thrown. 

Catch the exception and build a page with 

status code = 204 


HTTPResponse { 

statusCode = "204" 
) 


7 


value[] is null 

appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1, 

value= null, 

value Offset= 0, 
value Length= 1) 


Java . lang.NullPointerException 
is thrown. 

Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


8 


nameOffset<0 

appendHeaderVariable { 
name= [A] , 
nameOffset= -1, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 
valueLength= 1) 


j ava . lang . ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


9 


valueOffset<0 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
valueOffset= -1, 
valueLength= 1) 


j ava . lang . ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

statusCode = "204" 
) 


10 


nameLength<0 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= -1, 
value= [B] , 
valueOffset= 0, 
valueLength= 1) 


j ava . lang . ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


11 


valueLength<0 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 
valueLength= -1) 


Java . lang. ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


12 


nameOffset + nameLength > 
name.length 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 2 , 
value= [B] , 
valueOffset= 0, 
valueLength= 1) 


j ava . lang . ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


13 


valueOffset + valueLength > 
value.length 

appendHeaderVariable { 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 
valueLength= 2) 


j ava . lang . ArraylndexOutOf BoundsE 
xception is thrown. 
Catch the exception and build a page with 
status code = 204 


HTTPResponse { 

StatusCode = "204" 
) 


14 


finalizeHeader called previously 

writeStatusCode (200) 
appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1, 

value= [B] , 

valueOffset= 0, 

valueLength= 1) 
finalizeHeader { ) ; 

appendHeaderVariable { >, 
name= [C] , 
nameOffset= 0, 
nameLength= 1, 
value= [D] , 
valueOffset= 0, 
valueLength= l) ^ 

appendContent { [OK] ,0,2) ; 

flush {) ; 


> 


Uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS thrOWn. 

Catch the exception and continue the 
procedure. 


HTTPResponse { 

statusCode= "200" 

Header { "A" )= "B" 

Header { "Content-Length" ) = "2" 

HeaderNotPresent {"C" ) 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


15 


appendContent called previously 

writeStatusCode (200) 
appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1 , 










value= [B] , 
valueOffset= 0, 
valueLength= 1) 
appendContent { [OK] ,0,2) ; 




HTTPResponse { 

statusCode= "200" 

Header { "A" )= "B" 

Header { "Content -Length" ) = 

HeaderNotPresent {"C" ) 

contentBody= "OK" 
) 


"2" 


appendHeaderVariable { ^ 
name= [C] , 
nameOffset= 0, 
nameLength= 1, 
value= [D] , 
valueOffset= 0, 


> 


Uicc. sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS thrOWn. 

Catch the exception and continue the 




valueLength= 1) ^ 




procedure. 








flush {) ; 








16 


BUFFER_OVERFLOW 










writeStatusCode (200) 
appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1, 


uicc . sews . ScwsException with 
reason codes BUFFER_OVERFLOW iS 

thrown. 

Catch the exception and continue 


HTTPResponse { 
statusCode = "200" 
Header { "Content -Length" ) = 

HeaderNotPresent { "A" ) 


"0" 




value= [B] , 


the procedure. 








valueOffset= 0, 










valueLength= 










{remainingBuf f erLength-i-1) ) 








17 


flush called previously 

writeStatusCode (200) 
appendHeaderVariable { 

name= [A] , 

nameOffset= 0, 

nameLength= 1, 

value= [B] , 

valueOffset= 0, 

valueLength= 1) 




HTTPResponse { 
statusCode= "200" 
Header { "A" )= "B" 






appendContent { [OK] ,0,2) ; 




Header { " Content - Length " ) = 


"2" 




flush {) ; 




HeaderNotPresent {"C" ) 
contentBody= "OK" 






appendHeaderVariable { ^ 






) 






name= [C] , 




uicc . sews . ScwsException with 








nameOffset= 0, 




reason codes 








nameLength= 1, 


> 


HTTP RESPONSE ALREADY SENT iS 








value= [D] , 




thrown. 








valueOffset= 0, 

valueLength= 1) ^ 




Catch the exception and continue the 
procedure. 






18 


sendError called previously 

sendError (500) 










appendHeaderVariable { ^ 
name= [A] , 
nameOffset= 0, 
nameLength= 1, 
value= [B] , 
valueOffset= 0, 


> 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 


HTTPResponse { 
statusCode= "500" 
HeaderNotPresent { "A" ) 

) 






valueLength= 1) ^ 




procedure. 
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6.1 .5.4 Method appendHeaderVariable (short headerKeywordNameld, byteQ value, 

short valueOffset, short valueLength) 

Test Area Reference: Api_l_Hrs_Ahvas_Bss. 

6.1.5.4.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void appendHeaderVariable {short headerKeywordNameld, 

byte [] value, 
short valueOffset, 
short valueLength) 
throws ScwsException 

6.1.5.4.1.1 Normal execution 

• CRRNl: Appends a header variable to outgoing. The colon and space (":") as well as the "CRLF" will be 
appended automatically. 

• CRRN2: The header variables content-length or transfer-encoding are inserted by the framework depending on 
the transfer mode. 

6.1 .5.4.1 .2 Parameter Errors 

• CRRPl: if value is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if parameter valueOffset is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if parameter valueLength is negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP4: if parameter valueOffset plus valueLength are greater than the length of array data, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

• CRRP5: if parameter headerKeywordNameld is not correct according to SCWSConstants , a 
uicc . sews . ScwsException with reason codes UNKNOWN_KEYWORD_ID is thrown. 

6.1 .5.4.1 .3 Context errors 

• CRRCl: if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER. ALREADY_FINALIZED is thrown. 

• CRRC2: if appending the header variable would cause an overflow of the response buffer, a 
uicc. sews. ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC3: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC4: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.4.2 Test area files 

Specific triggering: None 

Test Source: Test_Api_l_Hrs_Ahva_sBss.java. 

Test Applet: Api_l_Hrs_ Ahva_sBss_l .Java. 

Cap File: Api_l_Hrs_ Ahva_sBss.cap. 
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6.1 .5.5 Method enableChunkMode 

Test Area Reference: Api_l_Hrs_Encm. 

6.1.5.5.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void enableChunkMode { ) 

6.1.5.5.1.1 Normal execution 

• CRRNl: Informs the SCWS to use the chunked mode for sending the response. 

• CRRN2: Chunked mode off is the default mode. 

• CRRN3: This allows the SCWS to handle large amounts of response data. 

6.1.5.5.1.2 Parameter Errors 

• n/a. 



6.1.5.5.1.3 



Context errors 



• CRRCl : if the HTTP header was already finalized, a uicc.scws.ScwsException with reason codes 
HEADER. ALREADY_FINALIZED is thrown. 

• CRRC2: if the flush method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC3: if the sendError method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.5.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.5.3 



Test_Api_ 1 _Hrs_Encm.j ava. 
Api_ 1 _Hrs_Encm_ 1 .j ava. 
Api_ 1 _Hrs_Encm. cap . 



Test coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 11 


N2 


4 


N3 


5,6 


C1 


7,8 


C2 


9 


C3 


10 
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6.1.5.5.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


1 


call in First 

enableChunkMode { ) 




HTTPResponse ( 




writeStatusCode (200) 




statusCode= "200" 




appendHeaderVariable { 




Header ( "Accept" ) = "headerl" 




headerKeywordNameId= 1, 




Header ( "Transfer -Encoding" ) = 




value= [headerlheader2] , 




"chunked" 




valueOffset= 0, 




contentBody= "OK" 




valueLength= 7) 




) 




f inalizeHeader { ) ; 








appendContent { [OK] ,0,2) ; 








flush {) ; 






2 


write StatusCode call before 

writeStatusCode (200) 








enableChunkMode { ) 




HTTPResponse ( 
statusCode= "200" 




appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 




Header ( "Accept" ) = "headerl" 
Header ( "Transfer -Encoding" ) = 
"chunked" 

contentBody= "OK" 




valueLength= 7) 




1 




f inalizeHeader { ) ; 








appendContent { [OK] ,0,2) ; 








flush {) ; 






3 


appendHeaderVariable call before 

writeStatusCode (200) 








appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 
valueLength= 7) 




HTTPResponse ( 
statusCode= "200" 
Header ( "Accept" ) = "headerl" 
Header ( "Transfer -Encoding" ) = 

"chunked" 




enableChunkMode { ) 




contentBody= "OK" 
) 




f inalizeHeader { ) ; 








appendContent { [OK] ,0,2) ; 








flush {) ; 






4 


default mode off 








writeStatusCode (200) 
appendHeaderVariable { 

headerKeywordNameId= 1, 

value= [headerlheader2] , 

valueOffset= 0, 

valueLength= 7) 
f inalizeHeader { ) ; 




HTTPResponse ( 

statusCode= "200" 

Header ( "Accept" ) = "headerl" 

Content -Length: "2" 

HeaderNotPresent ( "Transfer- 
Encoding" ) 

contentBody= "OK" 
) 




appendContent { [OK] ,0,2) ; 




1 




flush {) ; 






5 


large data several append 

writeStatusCode (200) 
enableChunkMode { ) 
f inalizeHeader { ) ; 








appendContent { [aaa. . 


.] , 0, 2048) 










appendContent { [aaa. . 
appendContent { [aaa. . 
appendContent { [aaa. . 
appendContent { [aaa. . 










2048) 
2048) 
2048) 
2048) 






HTTPResponse ( 

statusCode= "200" 

Header ( "Transfer -Encoding" ) = 
" chunked" 




appendContent { [aaa. . 
appendContent { [aaa. . 








2048) 
2048) 






^f XX l.4XXJ^^^.X 

contentBody= "aaa..." 




appendContent { [aaa. . 







2048) 






1 




appendContent { [aaa. . 







2048) 










appendContent { [aaa. . 







2048) 










flush {) ; 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 




6 


large data one append 

writeStatusCode (200) 




HTTPResponse ( 
statusCode= "200" 






enableChunkMode { ) 




Header ( "Transfer -Encoding" ) 
"chunked" 


= 




f inalizeHeader { ) ; 




contentBody= "aaa. . . " 






appendContent { [aaa. ..],0, 10240); 










flush {) ; 








7 


header already finalized 01 

writeStatusCode (200) 
appendHeaderVariable { 

headerKeywordNameId= 1, 

value= [headerlheader2] , 

valueOffset= 0, 

valueLength= 7) 




HTTPResponse ( 
statusCode= "200" 
Header ( "Accept" ) = "headerl' 






f inalizeHeader { ) ; 




Header ( "Content-Length" ) = ' 
HeaderNotPresent ( "Transfer- 


2" 




enableChunkMode { ) ; "1 


Uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


Encoding" ) 

contentBody= "OK" 
) 






appendContent { [OK] ,0,2) ; 










flush {) ; 








8 


header already finalized 02 

writeStatusCode (200) 
appendHeaderVariable { 

headerKeywordNameId= 1, 

value= [headerlheader2] , 

valueOffset= 0, 

valueLength= 7) 




HTTPResponse ( 
statusCode= "200" 
Header ( "Accept" ) = "headerl' 






f inalizeHeader { ) ; 




Header ( "Content-Length" ) = ' 


2" 




appendContent { [OK] ,0,2) ; 




HeaderNotPresent ( "Transfer- 
Encoding" ) 






enableChunkMode { ) ; 


uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


contentBody= "OK" 
) 






flush {) ; 








9 


flush called previously 

writeStatusCode (200) 
appendHeaderVariable { 

headerKeywordNameId= 1, 

value= [headerlheader2] , 

valueOffset= 0, 

valueLength= 7) 




HTTPResponse ( 
statusCode= "200" 
Header ( "Accept" ) = "headerl' 






f inalizeHeader { ) ; 




Header ( "Content-Length" ) = ' 


2" 




appendContent { [OK] ,0,2) ; 




HeaderNotPresent ( "Transfer- 






flush {) ; 




Encoding" ) 

contentBody= "OK" 






enableChunkMode { ) ; 


uicc . sews . ScwsException with 
reason codes 

HTTP_RESPONSE_ALREADY_SENT is 
thrown . 

Catch the exception and continue the 
procedure. 


) 




10 


sendError called previously 

sendError (500) 










enableChunkMode { ) ; "1 


uicc . sews . ScwsException with 
reason codes 

HTTP_RESPONSE_ALREADY_SENT is 
thrown . 

Catch the exception and continue the 
procedure. 


HTTPResponse ( 

statusCode= "500" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


11 


Multiple success call 

enableChunkMode { ) 
writeStatusCode (200) 








enableChunkMode { ) 




HTTPResponse ( 




appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 
valueLength= 7) 




statusCode= "200" 

Header ( "Accept ") = "headerl" 

Header ( "Transfer -Encoding" ) = 
"chunked" 

contentBody= "OK" 
) 




enableChunkMode { ) 








enableChunkMode { ) 








f inalizeHeader { ) ; 








appendContent { [OK] ,0,2) ; 








flush {) ; 







6.1 .5.6 Method finalizeHeader 

Test Area Reference: Api_l_Hrs_Finh. 

6.1.5.6.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void finalizeHeader {) throws ScwsException 



6.1.5.6.1.1 



Normal execution 



CRRNl: Finalizes the header data in the outgoing buffer. It automatically adds missing header data with 
default values by the SCWS. 



6.1.5.6.1.2 
• n/a. 



Parameter Errors 



6.1.5.6.1.3 



Context errors 



CRRCl: if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER_ALREADY_FINALIZED is thrown. 

CRRC2: if the adding of missing header data would cause access outside the Response buffer, a 
uicc. sews. ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

CRRC3: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

CRRC4: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP RESPONSE ALREADY SENT is thrown. 
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Test Source: 
Test Applet: 
Cap File: 

6.1.5.6.3 



Test_Api_ 1 _Hrs_Finh.j ava. 
Api_ 1 _Hrs_Finh_ 1 . j a va . 
Api_l_Hrs_Finh.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1 


C1 


5,6 


C2 


- 


C3 


7 


C4 


8 



6.1.5.6.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


1 


Normal call 

writeStatusCode {200) 








appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 
valueLength= 7) 




HTTPResponse { 
statusCode= "200" 
Header { "Accept" ) = "headerl" 
Header {"Content-Length" ) = "2" 
contentBody= "OK" 




f inalizeHeader { ) ; 




) 




appendContent { [OK] ,0,2) ; 








flush {) ; 






2 


header already finalized 01 

writeStatusCode {200) 

appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 








valueOffset= 0, 
valueLength= 7) 




HTTPResponse { 
statusCode= "200" 




f inalizeHeader { ) ; 




Header { "Accept" ) = "headerl" 
Header { "Content -Length" ) = "2" 




f inalizeHeader {) ; ~~| 


Uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


contentBody= "OK" 
) 




appendContent { [OK] ,0,2) ; 








flush {) ; 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


3 


header already finalized 02 

writeStatusCode (200) 

appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 0, 








valueLength= 7) 




HTTPResponse { 
statusCode= "200" 




f inalizeHeader { ) ; 




Header { "Accept" ) = "headerl" 
Header { " Content - Length " ) = " 2 " 




appendContent { [OK] ,0,2) ; 




contentBody= "OK" 




f inalizeHeader { ) ; 


Uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 






flush {) ; 






4 


flush called previously 

writeStatusCode (200) 

appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 








valueOffset= 0, 




HTTPResponse { 




valueLength= 7 
) 




statusCode= "200" 

Header { "Accept" ) = "headerl" 




appendContent { [OK] ,0,2) ; 




Header {"Content-Length" ) = "2" 




flush {) ; 




contentBody= "OK" 




f inalizeHeader {) ; ~| 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 




5 


sendError called previously 

sendError (500) 








f inalizeHeader {) ; ~| 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

statusCode= "500" 
) 



6.1.5.7 Method flush 

Test Area Reference: Api_l_Hrs_Flus. 

6.1.5.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void flush {) 

6.1.5.7.1.1 Normal execution 

• CRRNl: Sends all data contained in the HTTP response. 

• CRRN2: If this method is invoked in fixed buffer mode after a previous invocation of the same method the 
sews will do nothing. 
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CRRN3: If this method is invoked in fixed buffer mode and the sendError() message was invoked previously 
the sews will do nothing. 



6.1.5.7.1.2 
• n/a. 

6.1.5.7.1.3 



CRRN4: Invoking this method for the first time implicitly finalizes the header of the HttpResponse. 
Parameter Errors 



Context errors 



• CRRCl : if the adding of missing header data would cause access outside the Response buffer, a 
uicc.scws.ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

6.1.5.7.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.7.3 



Test_Api_l_Hrs_Flus.java. 
Api_ 1 _Hrs_Flus_ 1 .j ava. 
Api _l_Hrs_Flus.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,5 


N2 


2 


N3 


6 


N4 


4 


C1 


- 



6.1.5.7.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Normal case + Chunk off 

writeStatusCode {200) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 

flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header {"Content-Length" ) = "2" 

contentBody= "OK" 
) 


2 


Repeat flush + chunk off 

writeStatusCode {200) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 

flush {) ; 
flush {) ; 
flush {) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header {"Content-Length" ) = "2" 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


3 


Normal case + chunk on 

writeStatusCode (200) 
enableChunkMode { ) ; 
f inalizeHeader { ) ; 
appendContent { [Hello] ,0,5) ; 

flush {) ; 

appendContent { [ ] , , 1) ; 

flush {) ; 

appendContent { [World] ,0,5) ; 

flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "Transfer-Encoding" ) = 
" chunk " 

contentBody= "Hello World" 
) 


4 


Finalized the http header 

writeStatusCode (200) ; 
flush {) ; 




HTTPResponse { 
statusCode= "200" 
Header { " Content - Length " ) = " " 

contentBody= " " 
) 


5 


No flush 

writeStatusCode (200) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 




HTTPResponse { 

statusCode= "200" 

Header { " Content - Length " ) = " 2 " 

contentBody= "OK" 
) 


6 


SendError before 

sendError (500) ; 
flush {) ; 




HTTPResponse { 

statusCode= "500" 
) 



6.1.5.8 Method getRemainingResponseBufferSize 

Test Area Reference: Api_l_Hrs_Grrs. 

6.1.5.8.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

int getRemainingResponseBufferSize { ) 

6.1.5.8.1.1 Normal execution 

• CRRNl: Returns the remaining size of the Response Buffer available for this applet. 

• CRRN2: The size returned by this method is guaranteed until the next header data is added to the Response 
Buffer. 

• CRRN3: The size returned by this method is guaranteed until the content data is added to the Response Buffer. 

• CRRN4: Returns -1 if chunked mode is switched on. 



6.1.5.8.1.2 
• n/a. 

6.1.5.8.1.3 



Parameter Errors 



Context errors 



• CRRCl: if the flush method was called previously and the selected transfer mode is "Fixed transfer mode", a 
uicc.scws.ScwsException with reason codes HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC2: if the sendError method was called previously and the selected transfer mode is "Fixed transfer 
mode", a uicc.scws.ScwsException with reason codes HTTP_RESPONSE_ALREADY_SENT is thrown. 
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Test Source: 
Test Applet: 
Cap File: 

6.1.5.8.3 



Test_Api_ 1 _Hrs_Grrs .j ava. 
Api_l_Hrs_Grrs_l .Java. 
Api_l_Hrs_Grrs.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


3 


N3 


1 


N4 


2 


C1 


4 


C2 


5 



6.1.5.8.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


1 


Remaining content data 

writeStatusCode (200) 
f inalizeHeader { ) 

remaining = 
getRemainingResponseBuf f erSize { ) ; 

appendContent ( 

data = [aaa. . . ] 

offset = 

length = remaining 
) 
flush {) 




HTTPResponse { 

statusCode= "200" 

Header { "Content -Length" ) = 
remaining 

contentBody = "AaA [...]" 
) 


2 


Remaining + Chunk on 

writeStatusCode (200) 
enableChunkMode { ) ; 
f inalizeHeader { ) ; 

remaining = 
getRemainingResponseBuf ferSize {) ; 

appendContent { [OK] ,0,2) ; 
flush {) ; 


remaining = -1 


HTTPResponse { 

statusCode= "200" 

Header { "Transfer-Encoding" ) = 
"chunked" 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


3 


Remaining header data 

writeStatusCode {200) 

remainingA = 
getRemainingResponseBuf f erSize { ) ; 








appendHeaderVariable { 
headerKeywordNameId= 1, 
value= [headerlheader2] , 
valueOffset= 7, 
valueLength= 7 

) 




HTTPResponse { 

statusCode= "200" 

Header {"Accept" ) = "header2" 

Header {"Content-Length" ) = "2" 

contentBody= "OK" 
) 


remainingB = 
getRemainingResponseBuf ferSize { ) ; 


remainingB < remainingA 




remainingC = 
getRemainingResponseBuf ferSize { ) ; 


remainingB = remainingC 






f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 






4 


flush called previously 








writeStatusCode {200) 
f inalizeHeader { ) ; 
appendContent { [OK] ,0,2) ; 
flush {) ; 

getRemainingResponseBuf ferSize { ) •] 


Uicc. sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

statusCode= "200" 

Header {"Content-Length") = "2" 

contentBody= "OK" 
) 


5 


sendError called previously 

sendError {500) 








getRemainingResponseBuf ferSize {) ;"1 


uicc. sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse { 

statusCode= "500" 
) 



6.1.5.9 Method reset 

Test Area Reference: Api_l_Hrs_Rset. 

6.1.5.9.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void reset {) throws ScwsException 

6.1.5.9.1.1 Normal execution 

• CRRNl: Clears the Response Buffer content. 

• CRRN2: Reset the state of the HttpResponse Object to its initial state. 

• CRRN3: All the header variables and content that was appended to the HttpResponse until the invocation 
of the reset method is lost. 
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6.1.5.9.1.2 

• n/a. 

6.1.5.9.1.3 



Parameter Errors 



Context errors 



• CRRCl : if the flush method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC2: if the sendError method was called previously, a uicc.scws.ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 



6.1.5.9.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.9.3 



Test_Api_ 1 _Hrs_Rset.j ava. 
Api_l_Hrs_Rset_l .Java. 
Api_ 1 _Hrs_Rset.cap . 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


1,2,3 


N3 


1,2,3 


C1 


6 


02 


7 



6.1.5.9.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Reset StatusCode 

writeStatusCode {204) 
reset { ) ; 




HTTPResponse { 

statusCode= "200" 

Header { " Content - Length " ) = " 2 " 

contentBody = "OK" 
) 


writeStatusCode {200) , • 




f inalizeHeader { ) ; 
appendContent { [OK] , , 2 ) ; 
flush {) ; 




2 


Reset Header 

writeStatusCode {500) ; 
appendHeaderVariable {8 , [LI] 
, , 2 ) ; 

reset {) ; 

appendHeaderVariable {8 , [L2] 
, , 2 ) ; 

appendContent { [OK] , , 2 ) ; 
flusli{) ; 




HTTPResponse { 

statusCode= 200 

Header {"Content-Length" ) = "2" 

Header { " Content - Language " ) = " L2 " 

contentBody = "OK" 
) 


3 


Reset ContentType 

setContentType {4) ; 
reset { ) ; 

writeStatusCode {200) ; 
appendContent { [OK] , , 2 ) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header {"Content-Length" ) = "2" 

Header { " Content - Type " ) = 
"text /plain" {default value) . 

contentBody = "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


4 


Reset Header Finalized 

writeStatusCode {200) ; 
appendHeaderVariable {8, [LI] 
, , 2 ) ; 
f inalizeHeader { ) ; 

reset {) ; 

appendHeaderVariable {8 , [L2] 
, , 2 ) ; 

appendContent { [OK] , , 2 ) ; 
flush {) ; 




HTTPResponse { 
statusCode= "200" 
Header { " Content - Length " ) = " 2 " 
Header { "Content -Language" ) = "L2" 

contentBody = "OK" 
) 


5 


Reset Data 

writeStatusCode {200) ; 
appendHeaderVariable {8 , [LI] 
, , 2 ) ; 

f inalizeHeader { ) ; 
appendContent { [NOT OK] , , 
S) ; 

reset { ) ; 

appendContent { [OK] , , 2 ) ; 
flush {) ; 




HTTPResponse { 

statusCode= "200" 

Header { "Content-Length" )= "2" 

HeaderNotPresent {"Content- 
Language" ) 

contentBody = "OK" 
) 


6 


flush() called previously 

writeStatusCode {200) ; 
f inalizeHeader { ) ; 
appendContent { [OK] , , 2 ) ; 
flush {) ; 

reset { ) ; 

> 


uicc . sews . ScwsException with reason 
codes HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the procedure. 


HTTPResponse { 

statusCode= "200" 

Header {"Content-Length" ) = "2" 

contentBody = "OK" 
) 


7 


sendError called previously 

sendError {500) ; 

reset { ) ; ~| 


uicc. sews . ScwsException with reason 
codes HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the procedure. 


HTTPResponse { 

statusCode= "500" 
) 



6.1 .5.1 Method sendError 

Test Area Reference: Api_l_Hrs_Sene. 

6.1.5.10.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void sendError {short errorCode) 

6.1.5.10.1.1 Normal execution 

• CRRN 1 : Sends an error code to the SC WS . 

• CRRN2: The HTTP response is sent immediately by the SCWS no other data is send by the SCWS. 

• CRRN3: Missing header variables are added by the SCWS with their default values. 

• CRRN4: Invoking this method implicitly finalizes the header of the HttpResponse. 
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6.1.5.10.1.2 



Parameter Errors 



CRRPl: if parameter errorCode is unknown with respect to the HTTP 1.1 protocol, a 

uicc . sews . ScwsException with reason codes HTTP_CODE_UNKNOWN is thrown. 



6.1.5.10.1.3 



Context errors 



• CRRCl : if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER. ALREADY_FINALIZED is thrown. 

• CRRC2: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC3: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.10.2 Test area files 

Specific triggering: None: 

Test Source: Test_Api_l_Hrs_Sene.java. 

Test Applet: Api_l_Hrs_Sene_l.java. 

Cap File: Api_l_Hrs_Sene.cap. 



6.1.5.10.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5,6 


N2 


1,2,3,4,5,6 


N3 


1,2,3,4,5,6 


N4 


1,2,3,4,5,6 


PI 


7 


C1 


8,9 


C2 


10 


C3 


11 
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6.1.5.10.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


Normal use case : Return an Informational code (1xx) 


a 


// SC_CONTINUE 
sendError (100) 




Not testable 


b 


// SC_SWITCHING_PROTOCOLS 
sendError (101) 




Not testable 


2 


Normal use case : Return a Successful code (2xx) 


a 


// SC_OK 
sendError (200) 




HTTPResponse ( 

statusCode= 2 00 
) 


b 


// SC_CREATED 
sendError (201) 




HTTPResponse ( 

statusCode= 201 
) 


c 


// SC^ACCEPTED 
sendError (202) 




HTTPResponse ( 

statusCode= 202 
) 


d 


// 

SC_NON_AUTHORITATIVE_INFORMATION 
sendError (203) 




HTTPResponse ( 

statusCode= 2 03 
) 


e 


// SC_NO_CONTENT 
sendError (204) 




HTTPResponse ( 

statusCode= 2 04 
) 


f 


// SC_RESET_CONTENT 
sendError (205) 




HTTPResponse ( 

statusCode= 205 
) 




// SC_PARTIAL_CONTENT 
sendError (206) 




HTTPResponse ( 

statusCode= 206 
) 


3 


Normal use case : Return a Redirection code (3xx) 


a 


// SC_MULTIPLE_CHOICES 
sendError (300) 




HTTPResponse ( 

statusCode= 300 
) 


b 


// SC_MOVED_PERMANENTLY 
sendError (301) 




HTTPResponse ( 

statusCode= 301 
) 


c 


// SC_FOUND 
sendError (302) 




HTTPResponse ( 

statusCode= 302 
) 


d 


// SC_SEE_OTHER 
sendError (303) 




HTTPResponse ( 

statusCode= 303 
) 


e 


// SC_NOT_MODIFIED 
sendError (304) 




HTTPResponse ( 

statusCode= 3 04 
) 


f 


// SC_USE_PROXY 
sendError (305) 




HTTPResponse ( 

statusCode= 305 
) 


g 


// SC_TEMPORARY_REDIRECT 
sendError (307) 




HTTPResponse ( 

statusCode= 307 
) 


4 


Normal use case : Return a client error code (4xx) 


a 


// SC_BAD_REQUEST 
sendError (400) 




HTTPResponse ( 

statusCode= 400 
) 


b 


// SC_UNAUTHORIZED 
sendError (401) 




HTTPResponse ( 

statusCode= 401 
) 


c 


// SC_PAYMENT_REQUIRED 
sendError (402) 




HTTPResponse ( 

statusCode= 402 
) 


d 


// SC_FORBIDDEN 
sendError (403) 




HTTPResponse ( 

statusCode= 403 
) 


e 


// SC_NOT_FOUND 
sendError (404) 




HTTPResponse ( 

statusCode= 404 
) 
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Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 




f 


// SC_METHOD_NOT_ALLOWED 
sendError (405) 




HTTPResponse ( 

statusCode= 405 
) 


g 


// SC_NOT_ACCEPTABLE 
sendError (406) 




HTTPResponse ( 

statusCode= 40G 
) 


h 


// 

SC_PROXY_AUTHENTICATION_REQUIRED 
sendError (407) 




HTTPResponse ( 

statusCode= 407 
) 


i 


// SC_REQUEST_TIMEOUT 
sendError (408) 




HTTPResponse ( 

statusCode= 408 
) 


J 


// SC_CONFLICT 
sendError (409) 




HTTPResponse ( 

statusCode= 409 
) 


k 


// SC_GONE 
sendError (410) 




HTTPResponse ( 

statusCode= 410 
) 


1 


// SC_LENGTH_REQUIRED 
sendError (411) 




HTTPResponse ( 

statusCode= 411 
) 


m 


// SC_PRECONDITION_FAILED 
sendError (412) 




HTTPResponse ( 

statusCode= 412 
) 


n 


// SC_REQUEST_ENTITY_TOO_LARGE 
sendError (413) 




HTTPResponse ( 

statusCode= 413 
) 





// SC_REQUEST_URI_TOO_LONG 
sendError (414) 




HTTPResponse ( 

statusCode= 414 
) 


P 


// SC_UNSUPPORTED_MEDIA_TYPE 
sendError (415) 




HTTPResponse ( 

statusCode= 415 
) 


q 


// 

SC_REQUESTED_RANGE_NOT_SATISFIABLE 
sendError (416) 




HTTPResponse ( 

statusCode= 41S 
) 


r 


// SC_EXPECTATION_FAILED 
sendError (417) 




HTTPResponse ( 

statusCode= 417 
) 


5 


Normal use case : Return a Server Error 5xx code 


a 


// SC_INTERNAL_SERVER_ERRGR 
sendError (500) 




HTTPResponse ( 

statusCode= 500 
) 


b 


// SC_NOT_IMPLEMENTED 
sendError (501) 




HTTPResponse ( 

statusCode= 501 
) 


c 


// SC_BAD_GATEWAY 
sendError (502) 




HTTPResponse ( 

statusCode= 502 
) 


d 


// SC_SERVICE_IINAVAILABLE 
sendError (503) 




HTTPResponse ( 

statusCode= 503 
) 


e 


// SC_GATEWAY_TIMEOUT 
sendError (504) 




HTTPResponse ( 

statusCode= 504 
) 


f 


// SC_HTTP_VERSION_NOT_SUPPORTED 
sendError (505) 




HTTPResponse ( 

statusCode= 505 
) 


6 


After writeStatusCode 

writeStatusCode (200) ; 
sendError (403) ; 




HTTPResponse ( 

statusCode= 403 
) 



ETSI 



(Release 7) 



66 



ETSI TS 102 835 V7.1.0 (2010-10) 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


7 


HTTP_CODE_UNKNOWN 

sendError (0) 
sendError (-1) 
sendError (1000) 
sendError (99) 










sendError (102) 
sendError (199) 
sendError (207) 
sendError (299) 
sendError (308) 
sendError (399) 
sendError (418) 


uicc. sews . ScwsException with 
reason codes 
HTTP_CODE_DNKNOW iS thrOWn. 
Catch the exception and 
build a page with status 
code =2 04 


HTTPResponse ( 

statusCode = "204" 
) 






sendError (499) 










sendError (506) 










sendError (600) 










sendError (700) 










sendError (800) 










sendError (900) 








8 


finalizeHeader called previously 

writeStatusCode (200) 
finalizeHeader ( ) ; 










sendError (403) ; 


Uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse ( 

statusCode= 200 

Header ( "Content -Length" ) = 

contentBody= "OK" 
) 


'2" 




appendContent ( [OK] ,0,2) ; 










flush ; 








9 


appendContent called previously 

writeStatusCode (200) 
appendContent ( [OK] ,0,2) ; 




HTTPResponse ( 






sendError (403) ; 


uicc . sews . ScwsException with 


statusCode= 200 








reason codes 


Header ( "Content -Length" ) = 


'2" 






HEADER ALREADY FINALIZED iS 


contentBody= "OK" 








thrown. 


) 








Catch the exception and continue the 










procedure. 








flush ; 








10 


flush called previously 

writeStatusCode (200) 
appendContent ( [OK] ,0,2) ; 
flush ; 




HTTPResponse ( 
statusCode= 200 






sendError (4 03) ; 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


Header ( "Content -Length" ) = 
contentBody= "OK" 
) 


'2" 


11 


sendError called previously 

sendError (500) ; 










sendError (4 03) ; 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse ( 

statusCode= 500 
) 
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6.1.5.11 Method setContentType 

Test Area Reference: Api_l_Hrs_Scot. 

6.1 .5.1 1 .1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void setContentType {short type) throws ScwsException 

6.1.5.11.1.1 Normal execution 

• CRRNl: Sets the content type of the HTTP response. 

6.1.5.11.1.2 Parameter Errors 



CRRPl: if parameter type is not correct according to SCWSConstants , a 

uicc . sews . ScwsException with reason codes UNKNOWN_KEYWORD_ID is thrown. 



6.1.5.11.1.3 



Context errors 



• CRRCl: if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER_ALREADY_FINALIZED is thrown. 

• CRRC2: if appending the header variable would cause an overflow of the response buffer, a 
uicc. sews. ScwsException with reason codes BUFFER_OVERFLOW is thrown. 

• CRRC3: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

• CRRC4: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

6.1.5.11.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 

6.1.5.11.3 



Test_Api_l_Hrs_Scot.java. 
Api_l_Hrs_Scot_l .Java. 
Api_l_Hrs_Scot.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


P1 


6 


C1 


7,8 


C2 


- 


C3 


9 


C4 


10 
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6.1.5.11.4 



Test procedure 



Test Case 



Id 



Description 



API/SCWS Framework 
Expectation 



APDU/HTTP Expectation 



All success type 



// CONTENT_TYPE_IMAGE_GIF 
writeStatusCode (200) 
setContentType (4) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 

statusCode= "200" 

Header ( "Content -Type" ) = "image/gif " 

Header ( "Content -Length" ) = "2" 

contentBody= "OK" 
) 



// CONTENT_TYPE_IMAGE_JPEG 
writeStatusCode (200) 
setContentType (3) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "image/jpeg" 

Header ( "Content -Length" ) = "2" 

contentBody= "OK" 
) 



// CONTENT_TYPE_IMAGE_PNG 
writeStatusCode (200) 
setContentType (5) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 
statusCode= 200 
Header ( "Content -Type" ) = 
Header ( "Content -Length' 

contentBody= "OK" 

) 



"image/png" 

)= "2" 



/ / CONTENT_TYPE_TEXT_HTML 
writeStatusCode (2 00) 
setContentType (1) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/html" 

Header ( "Content -Length" ) = "2" 

contentBody= "OK" 
) 



// CONTENT_TYPE_TEXT_PLi 
writeStatusCode (200) 
setContentType (2) ; 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/plain" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 



Call in first 

setContentType (2) ; 

writeStatusCode (200) 
final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/plain" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 



Call after status line 

writeStatusCode (200) 

setContentType (2) ; 

final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/plain" 

Header ( "Content -Length" ) = "2 " 

contentBody= "OK" 
) 



Call after appendHeaderVariable 

writeStatusCode (200) 
appendHeaderVariable ( 

headerKeywordNameId= 1, 

value= [header lheader2] , 

valueOffset= 0, 

valueLength= v) 

setContentType (2) ; 

final izeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 
statusCode= 200 
Header ( "Accept" ) = "headerl" 
Header ( "Content -Type" ) = "text/plain" 
Header ( "Content -Length" ) = "2" 
contentBody= "OK" 

) 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


5 


Multiple call 

writeStatusCode (200) 








set Content Type (5) ; 




HTTPResponse ( 




set Content Type (4) 






statusCode= 200 




set Content Type ( 3 ) 






Header ( " Content -Type " ) = " text/html " 




set Content Type ( 2 ) 






Header ( " Content- Length " ) = "2" 




set Content Type ( 1 ) 






contentBody= "OK" 
) 




final izeHeader ( ) ; 








appendContent ( [OK] ,0,2) ; 








flush ; 






6 


UNKNOWNKEYWORDID 

writeStatusCode (200) 








se t Content Type (0) ; "l 


uicc . sews .ScwsException with 






reason codes 








UNKNOWN_KEYWORD_ID iS thrOWn. 






setContentType ( -1) ; ]. 


uicc . sews . ScwsException with 






reason codes 






setContentType(6) ; 


UNKNOWN_KEYWORD_ID iS thrOWn. 






uicc . sews .ScwsException with 






reason codes 








UNKNOWN_KEYWORD_ID is thrOWn. 






setContentType ( -2 ) ; \ 


uicc . sews .ScwsException with 
reason codes 


HTTPResponse ( 
statusCode= 200 






UNKNOWN_KEYWORD_ID iS thrOWn. 


Header ( "Content -Type" ) = "text/plain" 
Header ( " Content- Length " ) = "2" 






Catch all exceptions and continue the 


contentBody= "OK" 






procedure. 


) 




setContentType (2) ; 








final izeHeader ( ) ; 








appendContent ( [OK] ,0,2) ; 








flush ; 






7 


finalizeHeader called previously 

writeStatusCode (200) 
final izeHeader ( ) ; 








setContentType (2) ; "L 


uicc . sews . ScwsException with 


HTTPResponse ( 




reason codes 


statusCode= 200 






HEADER_ALREADY_FINALIZED iS 


Header ( " Content- Length " ) = "2" 






thrown. 


contentBody= "OK" 






Catch the exception and continue the 


) 






procedure. 






appendContent ( [OK] , , 2 ) ; 








flush ; 






8 


appendContent called previously 

writeStatusCode (200) 
final izeHeader ( ) ; 








appendContent ( [OK] ,0,2) ; 




HTTPResponse ( 




setContentType (2) ; "L 


uicc . sews . ScwsException with 
reason codes 
HEADER_ALREADY_FINALIZED iS 

thrown. 

Catch the exception and continue the 

procedure. 


statusCode= 200 

Header ( "Content -Length" ) = "2" 

contentBody= "OK" 
) 




flush ; 







£75/ 



(Release 7) 



70 



ETSI TS 102 835 V7.1.0 (2010-10) 



Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


9 


flush called previously 

writeStatusCode (200) 
set Content Type (2) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 

se t Content Type (1) ; "L 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse ( 

statusCode= 200 

Header ( "Content -Type" ) = "text/plain 

Header ( " Content- Length " ) = "2" 

contentBody= "OK" 
) 


10 


sendError called previously 

sendError (500) 
setContentType (2) ; 


uicc . sews . ScwsException with 
reason codes 
HTTP_RESPONSE_ALREADY_SENT iS 

thrown. 

Catch the exception and continue the 

procedure. 


HTTPResponse ( 

statusCode= 500 
) 



6.1.5.12 Method writeStatusCode 

Test Area Reference: Api_l_Hrs_Wstc. 
6.1.5.12.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

void writeStatusCode (short code) 

throws ScwsException 

6.1 .5.12.1 .1 Normal execution 

• CRRN 1 : Write an HTTP status code into the outgoing buffer. 



6.1.5.12.1.2 



Parameter Errors 



CRRPl: if parameter code is unknown with respect to the HTTP 1.1 protocol , a 

uicc . sews . ScwsException with reason codes HTTP_CODE_UNKNOWN is thrown. 



6.1.5.12.1.3 



Context errors 



CRRCl: if the HTTP header was already finalized, a uicc. sews. ScwsException with reason codes 
HEADER. ALREADY_FINALIZED is thrown. 

CRRC2: if the writeStatusCode has already been invoked, a uicc. sews. ScwsException with reason codes 
STATUS_LINE_ALREADY_SET is thrown. 

CRRC3: if the appendHeaderVariable has already been invoked, a uicc. sews. ScwsException with reason 
codes STATUS_LINE_ALREADY_SET is thrown. 

CRRC4: if the flush method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP_RESPONSE_ALREADY_SENT is thrown. 

CRRC5: if the sendError method was called previously, a uicc. sews. ScwsException with reason codes 
HTTP RESPONSE ALREADY SENT is thrown. 
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6.1.5.12.2 Test area files 

Specific triggering: None: 



Test Source: 
Test Applet: 
Cap File: 



Test_Api_l_Hrs_Wstc.java. 
Api_ 1 _Hrs_Wstc_ 1 .j ava. 
Api_ 1 _Hrs_Wstc . cap . 



6.1.5.12.3 



Test coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5, 12 


P1 


6 


C1 


7 


C2 


8 


C3 


9 


C4 


10 


C5 


11 



6.1.5.12.4 



Test procedure 



Test Case 



Id 



Description 



API/SCWS Framework 
Expectation 



APDU/HTTP Expectation 



Normal use case : Return a basic page with an Informational status code (Ixx) 



// SC_CONTINUE 
writeStatusCode (100) 



Not testable 



// SC_SWITCHING_PROTOCOLS 
writeStatusCode (101) 



Not testable 



Normal use case : Return a basic page with a Successful status code (2xx) 



// SC_OK 

writeStatusCode (200) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody= 

) 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



200 

ent- Length" ) = 2 
OK" 



// SC_CREATED 
writeStatusCode (201) 
appendContent ( [OK] ,0,2) 
flush ; 



201 

ent-Length") = 2 
"OK" 



// SC_ACCEPTED 
writeStatusCode (202) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody 

) 



202 

ent-Length" ) = 2 
OK" 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC_NON_AUTHORITATIVE_INFORMATION 
writeStatusCode (203) 
appendContent ( [OK] ,0,2) ; 
flush ; 



203 

ent-Length" ) = 2 
"OK" 



// SC_NO_CONTENT 
writeStatusCode (204) 



HTTPResponse ( 
statusCode= 
Header ("Cont 

null // not p 

response . 

) 



204 

ent-Length" ) = 
resent in the 



// SC_RESET_CONTENT 
writeStatusCode (205) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



205 

ent-Length" ) = 2 
OK" 



// SC_PARTIAL_CONTENT 
writeStatusCode (206) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



206 

ent-Length" ) = 2 
"OK" 



£75/ 



(Release 7) 



72 



ETSI TS 102 835 V7.1.0 (2010-10) 



Test Case 



Id 



Description 



API/SCWS Framework 
Expectation 



APDU/HTTP Expectation 



Normal use case : Return a basic page with a Redirection status code (3xx) 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody= 

) 



// SC_MULTIPLE_CHOICES 
writeStatusCode (300) 
appendContent ( [OK] ,0,2) 
flush ; 



300 

ent- Length") = 2 
"OK" 



// SC_MOVED_PERMANENTLY 
writeStatusCode (301) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



301 

ent-Length" ) = 2 
OK" 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC_FOUND 
writeStatusCode (302) 
appendContent ( [OK] ,0,2) 
flush ; 



302 

ent-Length") = 2 
"OK" 



// SC_SEE_OTHER 
writeStatusCode (303) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



303 

ent-Length") = 2 
"OK" 



// SC_NOT_MODIFIED 
writeStatusCode (304) 



HTTPResponse ( 

statusCode= 
) 



304 



// SC_USE_PROXY 
writeStatusCode (305) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ( "Cont 
contentBody 

) 



305 

ent-Length" ) = 2 
OK" 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC_TEMPORARY_REDIRECT 
writeStatusCode (307) 
appendContent ( [OK] ,0,2) ; 
flush ; 



307 

ent-Length" ) = 2 
"OK" 



Normal use case : Return a basic page with a Client error status code (4xx) 



// SC_BAD_REQUEST 
writeStatusCode (400) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



400 

ent-Length") = 2 
"OK" 



// SC_DNAUTHORIZED 
writeStatusCode (401) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



401 

ent-Length" ) = 2 
OK" 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody= 

) 



// SC_PAYMENT_REQUIRED 
writeStatusCode (402) 
appendContent ( [OK] ,0,2) 
flush ; 



402 

ent-Length" ) = 2 
"OK" 



// SC_FORBIDDEN 
writeStatusCode (403) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



403 

ent-Length" ) = 2 
OK" 



// SC_NOT_FOUND 
writeStatusCode (404) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



404 

ent-Length" ) = 2 
"OK" 



// SC_METHOD_NOT_ALLOWED 
writeStatusCode (405) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 
statusCode= 
Header { "Cont 
contentBody 

) 



405 

ent-Length" ) = 2 
OK" 



// SC_NOT_ACCEPTABLE 
writeStatusCode (406) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



406 

ent-Length" ) = 2 
OK" 
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Test Case 



Id 



Description 



API/SCWS Framework 
Expectation 



APDU/HTTP Expectation 



/ / SC_PROXY_AUTHENTICATION_REQUIRED 
writeStatusCode (407) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody 

) 



407 

ent-Length" ) = 2 
"OK" 



HTTPResponse { 
statusCode= 
Header {"Cont 
contentBody= 

) 



// SC_REQUEST_TIMEOUT 
writeStatusCode (408) 
appendContent ( [OK] ,0,2) 
flush ; 



ent-Length") = 2 
"OK" 



// SC_CONFLICT 
writeStatusCode (409) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



409 

ent-Length" ) = 2 
"OK" 



HTTPResponse { 
statusCode= 
Header { "Cont 
contentBody= 

) 



// SC_GONE 

writeStatusCode (410) 
appendContent ( [OK] ,0,2) 
flush ; 



410 

ent-Length") = 2 
"OK" 



// SC_LENGTH_REQUIRED 
writeStatusCode (411) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



411 

ent-Length") = 2 
OK" 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody= 

) 



m 



// SC_PRECONDITION_FAILED 
writeStatusCode (412) 
appendContent ( [OK] ,0,2) ; 
flush ; 



412 

ent-Length" ) = 2 
"OK" 



// SC_REQUEST_ENTITY_TOO_ 
writeStatusCode (413) 
appendContent ( [OK] ,0,2) ; 
flush ; 



LARGE 



HTTPResponse ( 
statusCode= 
Header ( "Cont 
contentBody 

) 



413 

ent-Length" ) = 2 
OK" 



HTTPResponse ( 
statusCode= 
Header ("Cont 
contentBody 

) 



// SC_REQUEST_URI_TOO_LONG 
writeStatusCode (414) 
appendContent ( [OK] ,0,2) ; 
flush ; 



414 

ent-Length" ) = 2 
"OK" 



// SC_UNSUPPORTED_MEDIA_ 
writeStatusCode (415) 
appendContent ( [OK] ,0,2) ; 
flush ; 



TYPE 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



415 

ent-Length" ) = 2 
OK" 



HTTPResponse { 
statusCode= 
Header ("Cont 
contentBody 

) 



// SC_REQUESTED_RANGE_NOT_SATISFIABLE 
writeStatusCode (416) 
appendContent ( [OK] ,0,2) ; 
flush ; 



41S 

ent-Length" ) = 2 
"OK" 



// SC_EXPECTATION_FAILED 
writeStatusCode (417) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 
statusCode= 
Header { "Cont 
contentBody 

) 



417 

ent-Length" ) = 2 
OK" 



Normal use case : Return a basic page with a Server error status code (5xx) 



// SC_INTERNAL_SERVER_ERROR 
writeStatusCode (500) 
appendContent ( [OK] ,0,2) ; 
flush ; 



HTTPResponse { 

statusCode= 500 

Header ("Content-Length") ^ 

contentBody= "OK" 
) 



// SC_NOT_IMPLEMENTED 
writeStatusCode (501) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 

statusCode= 501 

Header ("Content-Length") ^ 

contentBody= "OK" 
) 



// SC_BAD_GATEWAY 
writeStatusCode (502) 
appendContent ( [OK] ,0,2) 
flush ; 



HTTPResponse { 

statusCode= 502 

Header ("Content-Length") = 

contentBody= "OK" 
) 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 




d 


// SC_SERVICE_UNAVAILABLE 
writeStatusCode (503) 
appendContent ( [OK] ,0,2) ; 




HTTPResponse ( 
statusCode= 503 
Header ("Content-Length" ) = 2 




e 


flush ; 




contentBody= "OK" 
) 


// SC_GATEWAY_TIMEOUT 




HTTPResponse ( 






writeStatusCode (504) 




statusCode= 504 






appendContent ( [OK] ,0,2) ; 




Header ("Content-Length" ) = 2 




f 


flush ; 




contentBody= "OK" 
) 


// SC_HTTP_VERSION_NOT_SUPPORTED 




HTTPResponse ( 






writeStatusCode (505) 




statusCode= 505 






appendContent ( [OK] ,0,2) ; 




Header ("Content-Length" ) = 2 






flush ; 




contentBody= "OK" 
) 


6 


HTTP_CODE_UNKNOWN 

writeStatusCode (0) 
writeStatusCode (-1) 
writeStatusCode (1000) 
writeStatusCode (99) 








writeStatusCode (102) 


uicc . sews . ScwsException 






writeStatusCode (199) 


with reason codes 






writeStatusCode (207) 


HTTP_CODE_UIINKNOW is 


HTTPResponse ( 




writeStatusCode (299) 


thrown . 


statusCode = "204" 




writeStatusCode (308) 


Catch ALL exceptions and 


) 




writeStatusCode (399) 


build a page with status 






writeStatusCode (418) 


code =2 04 






writeStatusCode (499) 








writeStatusCode (506) 








writeStatusCode (600) 








writeStatusCode (700) 








writeStatusCode (800) 








writeStatusCode (900) 






7 


header already finalized 

writeStatusCode (200) 
final izeHeader ( ) ; 








writeStatusCode (500) 


Uicc . sews . ScwsExcept ion 


HTTPResponse ( 






with reason codes 


statusCode= 200 






HEADER_ALREADY_FINALIZED iS 


Header ("Content-Length" ) = 2 






thrown. 


contentBody= "OK" 






Catch the exception and continue 


) 






the procedure. 






appendContent ( [OK] ,0,2) ; 








flush ; 






8 


writeStatusCode already invoked 

writeStatusCode (200) 








writeStatusCode (500) 


uicc . sews . ScwsException 








with reason codes 


HTTPResponse { 






STATUS_LINE_ALREADY_SET iS 


statusCode= 200 






thrown. 


Header ("Content-Length" ) = 2 






Catch the exception and continue 


contentBody= "OK" 






the procedure. 


) 




f inalizeHeader ( ) ; 








appendContent ( [OK] ,0,2) ; 








flush ; 
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Test Case 


Id 


Description 


API/SCWS Framework 
Expectation 


APDU/HTTP Expectation 


9 


append hHeaderVariable already involved 

writeStatusCode (200) 
appendHeaderVariable ( 

headerKeywordNameId= 10, 

value= [test] , 

valueOffset= 0, 

valueLength= 4 
) 

writeStatusCode (500) 

f inalizeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 


Uicc . sews . ScwsException 
with reason codes 
STATUS_LINE_ALREADY_SET iS 

thrown. 

Catch the exception and continue 

the procedure. 


HTTPResponse ( 
statusCode= 200 
Content-Length: 2 
Content-Type: test 
contentBody= "OK" 

) 


10 


flush called previously 

writeStatusCode (200) 
f inalizeHeader ( ) ; 
appendContent ( [OK] ,0,2) ; 
flush ; 

writeStatusCode (500) 


uicc . sews . ScwsException 
with reason codes 
HTTP_RESPONSE_ALREADY_SENT 

is thrown. 

Catch the exception and continue 

the procedure. 


HTTPResponse ( 
statusCode= 200 
Content-Length: 2 
contentBody= "OK" 

) 


11 
12 


sendError called previously 

sendError (500) 
writeStatusCode (200) 

writeStatusCode not called 

appendContent ( [OK] ,0,2) ; 
flush ( ) ; 


uicc . sews . ScwsException 
with reason codes 
HTTP_RESPONSE_ALREADY_SENT 

is thrown. 

Catch the exception and continue 

the procedure. 

Default status code is 200 . 


HTTPResponse ( 

statusCode= 500 
) 

HTTPResponse ( 
statusCode= 200 
Content-Length: 2 
contentBody= "OK" 

) 



6.2 sews Runtime Environment 

6.2.1 Applet state 

6.2.1 .1 Invokation of applets not in state selectable 

Test Area Reference: Api_2_Aps_Ivns. 

6.2.1 .1 .1 Conformance Requirement 

The sews Framework implementation shall be compliant to the following statement (TS 102 588 [2], clause 4.3): 
• Only an Applet that is in selectable state can be invoked by the SCWS. 



£75/ 



(Release 7) 



76 



ETSI TS 102 835 V7.1.0 (2010-10) 



6.2.1.1.1.1 Normal execution 

• CRRNl : Only an applet in selectable state can be invoked by the SCWS. 

• CRRN2 : If the applet is in non selectable state, then the SCWS does not invoke this one and returns an HTTP 
response with a error status code = SC_NOT_FOUND whatever the HTTP method. 



6.2.1.1.1.2 


Parameter Err( 


• n/a. 




6.2.1.1.1.3 


Context errors 


• n/a. 





6.2.1.1.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_2_Aps_Ivns.java. 

Test Applet: Api_2_Aps_Ivns_l.java. 

Cap File: Api_2_Aps_Ivns.cap. 



6.2.1.1.3 



Test coverage 



CRR number 


Test case number 


N1, N2 


1 


N1, N2 


2 


N1, N2 


3 


N1, N2 


4 


N1, N2 


5 


N1, N2 


6 


N1, N2 


7 



6.2.1.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 


1 


Invoke an applet LOCKED / UNLOCKED with HTTP methods: POST 

1 . Send POST HTTP REQUEST (1 ) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send POST HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send POST HTTP REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doPostO 

response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 




Check the HTTP 
RESPONSE (1): 

HTTPResponse { 

statusCode = 
"204" 

) 

RESPONSE (2): 

HTTPResponse { 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse { 

StatusCode = 
"204" 
) 
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Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 


2 


Invoke an applet LOCKED / UNLOCKED with HTTP methods: GET 

1 . Send GET HTTP REQUEST (1 ) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send GET HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send GET H 1 1 P REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doGetO 

response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

statusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


3 


Invoke an applet LOCKED / UNLOCKED with HTTP methods: DELETE 

1 . Send DELETE HTTP REQUEST (1) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send DELETE HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send DELETE HTTP REQUEST (3) to Api_2_Aps_lvns_1 

AoDlet source code in doDeleteO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

StatusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 


4 


Invoke an applet LOCKED / UNLOCKED with HTTP methods : HEAD 

1 . Send HEAD H II H REQUEST (1) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send HEAD HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send HEAD HTTP REQUEST (3) to Api_2_Aps_lvns_1 

AoDlet source code in doHeadO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

StatusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 
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Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 


5 


Invoke an applet LOCKED / UNLOCKED with HTTP methods : PUT 

1 . Send PUT HTTP REQUEST (1 ) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send PUT HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send PUT HTTP REQUEST (3) to Api_2_Aps_lvns_1 

Applet source code in doPutO 

response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

statusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


6 


Invoke an applet LOCKED / UNLOCKED with HTTP methods : OPTIONS 

1 . Send OPTIONS HTTP REQUEST (1 ) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send OPTIONS HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send OPTIONS HTTP REQUEST (3) to Api_2_Aps_lvns_1 

AoDlet source code in doOotionsO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

StatusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 


7 


Invoke an applet LOCKED / UNLOCKED with HTTP methods : TRACE 

1 . Send TRACE HTTP REQUEST (1) to Api_2_Aps_lvns_1 

2. Lock the applet Api_2_Aps_lvns_1 (non selectable state) 

3. Send TRACE HTTP REQUEST (2) to Api_2_Aps_lvns_1 

4. Unlock the applet Api_2_Aps_lvns_1 (selectable state) 

5. Send TRACE HTTP REQUEST (3) to Api_2_Aps_lvns_1 

AoDlet source code in doTraceO 




Check the HTTP 
RESPONSE (1): 

HTTPResponse ( 

StatusCode = 
"204" 
) 

RESPONSE (2): 

HTTPResponse ( 

StatusCode = 
"404" 
) 

RESPONSE (3): 

HTTPResponse ( 

StatusCode = 
"204" 
) 


response. writeStatusCode (ScwsConstants . SC_NO_CONTENT) ; 



6.2.1 .2 Registration remains valid if applet is not in selectable state 

Test Area Reference: Api_2_Aps_Regv. 

6.2.1.2.1 Conformance Requirement 

The sews Framework implementation shall be compliant to the following statement (TS 102 588, clause 4.2): 
• If the Applet is in a non selectable state, its registration to the SCWS is still valid. 
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6.2.1.2.1.1 Normal execution 

• CRRNl: If the Applet is in a non selectable state, its registrations to the SCWS is still valid. 

6.2.1 .2.1 .2 Parameter Errors 

• n/a. 



6.2.1.2.1.3 

• n/a. 



Context errors 



6.2.1.2.2 Test area files 

Specific triggering: Unrecognized envelope 



Test Source: 
Test Applet: 
Cap File: 

6.2.1.2.3 



Test_Api_2_Aps_Regv.j ava. 
Api_2_Aps_Regv_l .Java. 
Api_2_Aps_Regv.cap. 



Test coverage 



CRR number 


Test case number 


N1 


1 



6.2.1.2.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS 
Framework 
Expectation 


APDU/HTTP 
Expectation 


Map an applet in non selectable state 

1 . Register Api_2_Aps_Regv_1 to SCWS 

2. Lock tlie applet Api_2_Aps_Regv_1 (non selectable state) 

3. Map the Api_2_Aps_Regv_1 (1 ) 

4. Unlock the applet Api_2_Aps_Regv_1 ( selectable state) 

5. Send a HTTP REQUEST (2) to Api_2_Aps_Regv_1 

Applet source code in doPostO 

response. writeStatusCode(ScwsConstants.SC_NO_CONTENT) ; 




Api_2_Aps_Regv_ 1 
mapping success 
(1) 

Check the HTTP 
RESPONSE (2): 

HTTPResponse ( 

statusCode = 
"204" 

) 





6.2.2 Response sencJing 

All tests regarding sending of a response are implicitely covered by the test cases in clause 6.1.5. 
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6.2.3 Exception hancJIing 



6.2.3.1 No exception shall be propagated as HTTP error to the terminal 

Test Area Reference: Api_2_Exh_Noex. 

6.2.3.1.1 Conformance Requirement 

The sews Framework implementation shall be compliant to the following statement (TS 102 588 [2], clause 4.4): 

• Exceptions thrown by the invoked Applet shall not be propagated to the terminal, and the SCWS shall send an 
error status code according to HTTP 1.1 [1]. In case of "chunked mode", some response data could have 
already been sent by the SCWS. In this case, no error shall be sent by the SCWS. In case of "fixed buffer size 
mode", the status code is always sent by the SCWS. 



6.2.3.1.1.1 



Normal execution 



CRRNl: If an exceptions thrown by the invoked Applet the SCWS send an error status code according to 
HTTP 1.1[1]. 

CRRN2: In case of "chunked mode", if an exceptions thrown by the invoked Applet the SCWS and if some 
response data could have already been sent by the SCWS. Then, no error shall be sent by the SCWS. 

CRRN3: In case of "fixed buffer size mode", if an exceptions thrown by the invoked Applet the SCWS. Then, 
the status code is always sent by the SCWS. 



6.2.3.1.1.2 

• n/a. 

6.2.3.1.1.3 

• n/a. 



Parameter Errors 



Context errors 



6.2.3.1.2 Test area files 

Specific triggering: Unrecognized envelope: 

Test Source: Test_Api_2_Exh_Noex.java. 

Test Applet: Api_2_Exh_Noex_l.java. 

Api_2_Exh_Noex.cap. 



Cap File: 
6.2.3.1.3 



Test coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


N3 


3 
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6.2.3.1.4 



Test procedure 



Test Case 


Id 


Description 


API/SCWS Framework Expectation 


APDU/HTTP Expectation 


1 


AoDlet throws an exceotion 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


Byte [] array = new byte [2] 
Array [3] = 0x0 0; 


2 


In "chunked mode", aoolet 
throws an Exception AFTER 

writeStatusCode () 

enableChunkMode { ) 
writeStatusCode (200) 

Byte [] array = new byte [2] 
Array [3] = 0x0 0; 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


3 


In "chunked mode", aoolet 
throws an Exception AFTER 

appendHeaderVariable () 

enableChunkMode { ) 
writeStatusCode (200) 
appendHeaderVariable { "a : B", 
0, 4) 

Byte[] array = new byte [2] 
Array [3] = 0x0 0; 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


4 


In "chunked mode", applet 
throws an Exception AFTER 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 
StatusCode = "200" 
Header = "A: B 
Content = "OK" 

) 


appendContent { ) 

enableChunkMode { ) 
writeStatusCode (200) 
appendHeaderVariable { "A: B", 
0, 4) 
appendContent {"OK" , 0, 2) 

Byte[] array = new byte [2] 
Array [3] = 0x0 0; 


5 


IiL'tixed buffer size mode ", 

applet throws an Exception 
AFTER writeStatusCode 

writeStatusCode (200) 

Byte[] array = new 

byte [2] 

Array [3] = 0x0 0; 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


6 


IrL'fixed buffer size mode", 

applet throws an Exception 

AFTER appendHeaderVariable 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 


{) 

writeStatusCode (200) 
appendHeaderVariable { "a : B", 
0, 4) 

Byte [] array = new byte [2] 
Array [3] = 0x0 0; 


7 


In "fixed buffer size model|j_ 

applet throws an Exception 

Ah 1 bR appendContent { ) 

writeStatusCode (200) 
appendHeaderVariable { "A: B", 
0, 4) 
appendContent {"OK" , 0, 2) 

Byte[] array = new byte [2] 
Array [3] = 0x0 0; 


j ava . lang . ArraylndexOutOf BoundsException 
is thrown 


HTTPResponse { 

StatusCode = "500" 
) 
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Annex A (normative): 

Class, methods and SCWSFramework tests acronyms 



A.1 Smart Card Web Server part 



ScwsExtensionRegistry 


Ser 


ScwsExtension 


Set 


ScwsExtensionService 


Ses 


HttpRequest 


Hrq 


HttpResponse 


Hrs 



A.1 .1 Class ScwsExtensionRegistry 



Method name 


Acronyms 


static void deregisterO 


Dreg 


static void register {) 


Regi 



A. 1.2 Class ScwsExtensionService 



Method Name 


Acronyms 


void doDeleteO 


Ddel 


void doGet { ) 


Dget 


void doHeadO 


Dhea 


void doOptionO 


Dopt 


void doPost { ) 


Dpos 


void doPut { ) 


Dput 


void doTraceO 


Dtra 



A.1 .3 HttpRequest interface 



Method Name 


Acronyms 


short f indAndCopyKeywordValue {byte [] 

headerKeywordName, short nameOffs, short nameLength, 
byte [] buffer, short bufferOffs, short maxLength) 


Fckw_Bss_Bss 


short f indAndCopyKeywordValue {short keywordid, 
byte [] buffer, short bufferOffs, short maxLength) 


Fckws_Bss 


int getContentLength { ) 


Gcle 


short getContentType { ) 


Gcty 


short getRequestHttpVersion { ) 


Grhv 


short readContent { ) 


Rcon 


short readContentType { ) 


Rcty 
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A. 1.4 HttpResponse interface 



Method Name 


Acronyms 


void appendContent { ) 


Aeon 


void appendHeaderVariable {byte [] data, short offset, 
short length) 


Ahva_Bss 


void appendHeaderVariable {byte [] name, short 
nameOffset, short nameLength, byte [] value, short 
valueOffset, short valueLength) 


Ahva_Bss_Bss 


void appendHeaderVariable {short headerKeywordNameld, 
byte [] value, short valueOffset, short valueLength) 


Ahvas_Bss 


void enableChunkMode { ) 


Encm 


void f inalizeHeader { ) 


Finh 


void flush {) 


Plus 


int getRemainingResponseBuf f erSize { ) 


Grrs 


void reset { ) 


Rset 


void sendError{) 


Sene 


void setContentType { ) 


Scot 


void writeStatusCode { ) 


Wstc 



A. 2 Acronyms for SCWS Framework tests 



Method Name 


Acronyms 


Applet state 


Aps 


Exception handling 


Exh 



A.2.1 Applet state 



Test Area within the chapter 


Acronyms 


Invokation of applets not in state selectable 


Ivns 


Registration remains valid if applet is not in selectable state 


Regv 



A.2.3 Exception handling 



Method Name 


Acronyms 


No exception shall be propagated as HTTP error to the terminal 


Noex 
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Annex B (normative): 
Test file description 



Every test source is written in JAVA^^ and shall use methods defined in Annex C interfaces to communicate with the 
card. 

In order to be more readable, data specified as method string parameters shall be presented in 4 blocks of 4 bytes per 
line. Every block is separated by a space character. Every string line is appended to previous one and shall be aligned. 
An example is provided in annex C. 

Every test file shall start with a call to reset() method. 
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Annex C (normative): 

uicc.scws.test.util package and interfaces 

See attached files: 

• Annex_C_ScwsTestUtil.zip. 

• Annex_C_ScwsInterfaces.zip. 

NOTE: These files are contained in archive ts_102835v070100p0.zip which accompanies the present document. 
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Annex D (normative): 
Test Area files 



See attached file: 

• Annex_D_SourceCode.zip. 

NOTE: This file is contained in archive ts_102835v070100p0.zip which accompanies the present document. 
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Annex E (informative): 

HTTP-Request and HTTP-Response handling 

The HttpClient V3.1 [i.2] from the Apache Software Foundation is used to handle HTTP requests and HTTP responses. 

It is permissible to use another framework for HTTP handling, in this case the interface 
ScwsApplicationManagementService has to be modified accordingly. 
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Annex F (informative): 
Bibliography 

• IETF RFC 791: "Internet Protocol". 

NOTE: Available at http://www.ietf.org/rfc/rfc79 1 .txt . 

• IETF RFC 2616: "Hypertext Transfer Protocol - HTTP/1.1". 
NOTE: Available at http://www.ietf.org/rfc/rfc2616.txt . 

• IETF RFC 793 : "Transmission Control Protocol" . 
NOTE: Available at http://www.ietf.org/rfc/rfc793.txt . 
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Annex G (informative): 
Change history 



The table below indicates all changes that have been incorporated into the present document since it was placed under 
change control. 



Change history 


Date 


Meeting 


Pienary Doc 


CR 


Rev 


Cat 


Subject/Comment 


Did 


New 














Creation of the specification 




7.0.0 


2010-07 


SCP #45 


SCP(10)0117 


1 


- 


F 


Test case 6.1.4.4 IVIethod getContentType 


7.0.0 


7.1.0 


2010-07 


SCP #45 


SCP(10)0117 


2 


- 


F 


Test case 6.1 .5.4 ID 4 not in line with TS 1 02 588 


7.0.0 


7.1.0 


2010-07 


SCP #45 


SCP(10)0117 


3 


- 


F 


Test case 6.2.1.2 Registration remains valid if applet is not 
in selectable state 


7.0.0 


7.1.0 


2010-07 


SCP #45 


SCP(10)0117 


4 


- 


F 


Implementation of test case 6.1 .4.3 


7.0.0 


7.1.0 
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V7.1.0 
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